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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  ( ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Pat terson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company.  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 


Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communi cat ions  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 
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Subcontractors  Role 

Illinois  Institute  of  Responsible  for  factory  view 

Technology  function  research  (IITRI) 

and  information  models  of 
small  and  medium-size  business 

North  American  Rockwell  Reviewer 

Northrop  Corporation  Responsible  for  factory  view 

function  and  information 
models 

Pritsker  and  Associates  Responsible  for  IDEF2  support 

SofTech  Responsible  for  IDEFO  support 


TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors  Role 

Boeing  Military  Aircraft  Responsible  for  consultation  on 

Company  ( BMAC )  applications  of  the  technology 

and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Control  Data  Corporation  Responsible  for  the  Common  Data 
(CDC)  Model  (CDM)  implementation  and 

part  of  the  CDM  design  (shared 
with  DACOM). 

D.  Appleton  Company  Responsible  for  the  overall  CDM 

(DACOM)  Subsystem  design  integration 

and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


Computer  Technology 
Associates  (CTA) 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonne 1 1  Doug 1 as 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP )  (In  1985 
became  McCormack  €?  Dodge) 


SofTech,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
( SDRC ) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Prime  contractors  under  other  projects  who  have  contributed 
to  Test  Bed  Technology,  their  contributing  activities  and 
responsible  projects  are  as  follows: 


Contractors 


ICAM  Project 


Contributin; 
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Boeing  Military 
Aircraft  Company 
( BMAC ) 


1701 ,  2201 ,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( ISMC ) 
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Contractors 
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Control  Data 
Corporation  (CDC) 
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Common  Data  Model 
Processor  (CDMP) 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  ( HAC ) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) 

Systran 


1502 


Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Ident i f i cat i on 


This  specification  establishes  the  detailed  design  of  a 
computer  program  identified  as  the  Virtual  Terminal,  hereinafter 
referred  to  as  the  VT.  The  VT  is  one  configuration  item  of  the 
Integrated  Information  Support  System  (IISS)  User  Interface 
(UI). 

1 .2  Functional  Summary 

One  of  the  objectives  of  the  IISS  testbed  is  to  allow 
applications  to  be  run  from  a  wide  variety  of  terminals. 

Instead  of  the  application  programmer  having  to  worry  about  what 
commands  to  send  to  which  type  of  terminal  to  perform  what 
functions,  he  just  uses  commands  for  the  Virtual  Terminal.  The 
Virtual  Terminal  is  defined  just  like  a  real  terminal;  it  has  a 
set  of  functions  which  it  can  perform,  a  set  of  attributes  that 
it  supports,  a  set  of  commands  for  invoking  the  functions,  and 
modes  of  operation. 

The  VT  translates  between  the  Virtual  Terminal  commands  and 
commands  for  the  particular  type  of  terminal  a  user  has.  This 
process  is  not  as  simple  as  it  sounds  since  no  single  terminal 
provides  all  of  the  functions  and  attributes  that  the  Virtual 
Terminal  does.  Thus,  the  Virutal  Terminal  Interface  must 
simulate  missing  functions  with  existing  ones. 

In  addition  to  supporting  real  terminals,  the  VT  also 
performs  another  function  --  interfacing  existing  applications 
to  the  testbed.  An  existing  application  sends  (and  expects  to 
receive)  commands  for  a  particular  type  of  terminal.  In  the 
testbed  these  commands  are  intercepted  and  sent  to  the  Virtual 
Terminal  which  then  converts  the  commands  into  Virtual  Terminal 
commands,  just  as  if  they  had  been  entered  from  a  real  terminal. 
Of  couse.  it  also  converts  Virtual  Terminal  commands  to  the 
specific  terminal  commands  the  application  expects  to  receive. 
The  Virtual  Terminal  allows  an  application  to  be  run  from  a 
terminal  other  than  the  one  it  was  designed  for. 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


[1]  Structural  Dynamics  Research  Corporation,  Appl i cat  ion 
Interface  Product  Specification ,  PS  620144700  ,  1 
November  1985 . 

[2]  Structural  Dynamics  Research  Corporation,  Forms 
Driven  Form  Editor  Product  Specification. 

PS  620144402  ,  1  November  1985. 

[3]  Structural  Dynamics  Research  Corporation,  Forms 
Language  Compiler  Product  Specification , 

PS  620144401  ,  1  November  1985. 

[4]  Structural  Dynamics  Research  Corporation,  Form 
Processor  Product  Specification .  PS  620144200  , 

1  November  1985 . 

[5]  Structural  Dynamics  Research  Corporation,  Rapid 
Application  Generator  Product  Specification . 

PS  620144502  ,  1  November  1985. 

[6]  Structural  Dynamics  Research  Corporation,  Report 
Writer  Product  Specification.  PS  620144501  , 

1  November  1985 . 

[7]  Structural  Dynamics  Research  Corporation,  Text 
Editor  Product  Specification,  PS  620144600  , 

1  November  1985 . 

[8]  Structural  Dynamics  Research  Corporation,  User 
Interface  Services  Product  Specification. 

PS  620144100  ,  1  November  1985. 

[9]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Development  Specification,  DS  620144300B, 

1  November  1985. 

[10]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  User  Manual .  UM  620144300B,  1  November 
1985  . 
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[11]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Unit  Test  Plan ,  UTP620144300  ,  1  November 
1985. 

2 . 2  Terms  and  Abbreviations 

American  Standard  Code  for  Inf ormation  Interchange : 

(ASCII),  the  character  set  defined  by  ANSI  X3.4  and  used  by  most 
computer  vendors. 

Appi i cat i on  Interface :  (AI),  subset  of  the  IISS  User 
Interface  that  consists  of  the  callable  routines  that  are  linked 
with  applications  that  use  the  Form  Processor  or  Virtual 
Terminal.  The  AI  enables  applications  to  be  hosted  on  computers 
other  than  the  host  of  the  User  Interface. 

Appl i cation  Process :  (AP),  a  cohesive  unit  of  software  that 
can  be  initiated  as  a  unit  to  perform  some  function  or 
functions . 

Attribute:  field  characteristic  such  as  blinking, 
highlighted,  black,  etc.  and  various  other  combinations. 
Background  attributes  are  defined  for  forms  or  windows  only. 
Foreground  attributes  are  defined  for  items.  Attributes  may  be 
permanent,  i.e.,  they  remain  the  same  unless  changed  by  the 
application  program,  or  they  may  be  temporary,  i.e.,  they  remain 
in  effect  until  the  window  is  redisplayed. 

Commun i cat i on  Services :  allows  on  host  interprocess 
communication  and  inter-host  communication  between  the  various 
Test  Bed  subsystems. 

Computer  Program  Configuration  Item:  (CPCI).  an  aggregation 
of  computer  programs  or  any  of  their  discrete  portions,  which 
satisfies  an  end-use  function 

Device  Drivers :  (DD),  software  modules  written  to  handle 
I/O  for  a  specific  kind  of  terminal.  The  modules  map  terminal 
specific  commands  and  data  to  a  neutral  format.  Device  Drivers 
are  part  of  the  UI  Virtual  Terminal . 

Extended  Binary  Coded  Decimal  Interchange  Code  (EBCDIC), 
the  character  set  used  by  a  few  computer  vendors  (notably  IBM) 
instead  of  ASCII. 

Field :  two  dimensional  space  on  a  terminal  screen 
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Integrated  Information  Support  System :  (IISS),  a  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  data  bases  supported  by  heterogeneous  computers 
interconnected  via  a  Local  Area  Network. 

Logical  Device :  a  conceptual  device  which  to  an  application 
is  indistinguishable  from  a  physical  device  and  is  then  mapped 
to  part  or  all  of  a  physical  device. 

Network  Transaction  Manager :  (NTM),  IISS  subsystem  that 
performs  the  coordination,  communication  and  housekeeping 
functions  required  to  integrate  the  Application  Processes  and 
System  Services  resident  on  the  various  hosts  into  a  cohesive 
system. 

Operating  System:  (OS),  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Physical  Device :  a  hardware  terminal. 

User  Interface :  (UI),  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems:  the  User  Interface 
Development  System  (UIDS)  and  the  User  Interface  Management 
System  (UIMS). 

User  Interface  Management  System :  (UIMS),  the  runtime  UI . 

It  consists  of  the  Form  Processor,  Virtual  Terminal,  Application 
Interface,  the  User  Interface  Services  and  the  Text  Editor. 

User  Interface  Monitor :  (UIM),  part  of  the  Form  Processor 
that  handles  messaging  between  the  NTM  and  the  UI .  It  also 
provides  authorization  checks  and  initiates  applications. 

User  Interface/Virtual  Terminal  Interface :  (UI/VTI), 
another  name  for  the  User  Interface. 
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Virtual  Terminal :  (VT),  subset  of  the  IISS  User  Interface 
that  performs  the  interfacing  between  different  terminals  and 


the  UI . 
features 
software 
Spec i f ic 
software 


This  is  done  by  defining  a  specific  set  of  terminal 
and  protocols  which  must  be  supported  by  the  UI 
which  constitutes  the  virtual  terminal  definition, 
terminals  are  then  mapped  against  the  virtual  terminal 
by  specific  software  modules  written  for  each  type  of 


kui 


real  terminal  supported 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Description 

Figure  3-1  describes  the  structure  of  the  Virtual  Terminal . 
The  Virtual  Terminal  consists  of  some  routines  that  are  linked 
with  the  application  that  uses  it  (VT  Application  Monitor)  as 
well  as  a  process  that  performs  monitoring,  window  management 
activities  and  translation  of  VT  commands  into  commands  for  a 
specific  device. 
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Figure  3-1  Virtual  Terminal  Structure 
3 . 2  Functional  Flow 

The  Virtual  Terminal  can  be  used  in  two  different  modes: 
master  and  slave.  Currently,  the  master  mode  is  used  for 
interactive  devices  and  the  slave  mode  is  used  for  batch  devices 
such  as  printers. 

Figure  3-2  is  a  data  flow  for  the  Virtual  Terminal  in 
master  and  slave  mode. 
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Figure  3-2  Virtual  Terminal  Data  Flow 


3.3  Interfaces 


3.3.1  Physical  Terminal 


The  interface  to  a  physical  terminal  is  a  function  of  the 
host  Operating  System  (OS)  and  is  highly  system  dependent.  When 
somewhat  portable  functions  are  recognized,  they  are  isolated 
into  system  Independent  routines  thuE  making  as  much  of  the  code 
portable  as  is  possible. 


3.3.2 


>1  i  cat  ion 


Applications  can  use  the  VT  Application  Monitor  to 
communicate  with  the  VT  process.  The  types  of  messages  that  are 
sent  to  and  from  the  VT  process  are  dependent  upon  the  mode 
(master  or  slave)  of  the  VT  process  and  are  described  in  the 
next  two  sections  Device  data  messages  (type  DD)  contain  VT 
commands  and  data.  The  VT  commands  are  described  in  Appendix  A 
of  the  Virtual  Terminal  Development  Specification 
(DS  620 144300B ) . 
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3.3.2. 1  VT  Process  as  Master 
RECEIVE  MESSAGES 

Message  Type  Action  Taken/Buf fer 

SD  Terminates  Device  Driver. 

DD  Send  Device  Data  to  be  output  to  Virtual 

Terminal . 

DQ  Send  Device  Data  to  be  output  to  Virtual 

Terminal  and  request  for  acknowledgement. 

SEND  MESSAGES 

Message  Type  Action  Taken /Buffer 

DE  Informs  UIM  that  Master  Device  Driver  is 

entering  the  DIM  system  control . 

DD  Send  Device  Data  which  was  input  to  Virtual 

Terminal . 

Section  3. 2. 2. 1.2  of  the  Virtual  Terminal  Development 
Specification  contains  a  detailed  description  of  these 
messages . 

3. 3. 2. 2  VT  Process  as  Slave 
RECEIVE  MESSAGES 

Message  Type  Action  Taken/Buffer 

DE  Starts  up  Slave  Device  Driver. 

SD  Terminates  Device  Driver. 

DD  Send  Device  Data  to  be  output  to  Virtual 

Terminal . 


PS  620144300 
1  November  1985 


SEND  MESSAGES 


Message  Type  Action  Taken/ Buffer 

DI  Informs  UIM  that  slave  drive,  is  alive  and 

should  be  initialized  with  proper  size. 

DD  Send  Device  Data  which  was  input  to  Virtual 

Terminal . 

Section  3. 2. 2. 2. 2  of  the  Virtual  Terminal  Development 
Specification  contains  a  detailed  description  of  these 
messages . 

3.3.3  Terminal  User 


When  the  VT  process  is  the 
terminal  user.  It  has  a  number 
if  scripting  is  required. 

-w  -scripting  file  name » 
-r  -scripting  file  name > 
-s  -save  file  name > 


master  it  is  started  by  the 
of  parameters  that  can  be  used 


-  write  script  file 

-  read  script  file 

-  saves  output  from 
session 


These  arguments  are  optional.  The  user  can  either  create  a 
script  file,  read  a  scri  pt  file,  or  do  neither.  The  user  can 
also  save  or  not  save  the  output  from  a  session 


3 . 4  Program  Interrupts 

Attention  interrupts  received  from  the  terminal  (CNTL/C. 
break)  cause  the  VT  process  to  terminate  by  calling  the  NTM 
routine  TRMNAT . 


3.5  Timing  and  Sequencing  Description 

The  Monitor  processes  two  types  of  input:  keyboard 
characters  and  NTM  messages.  First,  a  check  is  made  for 
available  keyboard  characters.  As  long  as  characters  are 
available,  they  are  processed.  When  no  characters  are 
available,  a  check  is  made  for  NTM  messages.  If  a  message  is 
found,  it  is  processed  and  the  Monitor  again  checks  for  keyboard 
characters  If  no  message  is  available,  the  Monitor  waits  for 
approximately  .1  seconds  before  again  checking  for  keyboard 
characters . 
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3.6  Special  Control  Features 

The  detailed  design  of  the  VT  does  not  Include  any  special 
control  features  as  defined  in  the  ICAM  Documentation  Standards 
manual . 

3 . 7  Storage  Allocation 

The  executable  sizes  for  the  device  driver  routines  for 
each  supported  terminal  are: 


ADM  3  A 

172 

blocks 

CI600 

165 

blocks 

IBM3270 

not 

aval lable 

PRINTR 

153 

blocks 

PW3270 

not 

avai lable 

VIP 

174 

blocks 

VT100 

176 

blocks 

VT100W 

176 

blocks 

VTMIN 

175 

blocks 

3 . 8  Object  Code  Creation 

The  VT  routines  were  compiled  using  a  C  compiler  developed 
by  Interactive  Software  under  VAX/VMS. 

3.9  Adaptation  Data 

The  C  source  modules  for  the  VT  can  be  compiled  using  any 
UNIX  version  7  compatible  C  compiler.  All  routines  beginning 
with  'TRM'  are  device  dependent,  and  the  routine  TERMIO.C  is  VAX 
specific . 

3.10  Detailed  Design  Description 
3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs”  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or.  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed  Note  whether  the  routine 
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Program,  Subroutine,  or  Function.  If  it  is  a 
ruly  a  main  program  entry  point.  If  not,  then 
called  by  other  programs  not  being  documented  here 


Program,  it 
it  is  merely 
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Module  Name 


DRIVER/MAIN 


VIRTUAL  TERMINAL  Main  Program  List 
Purpose 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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Module  Name 

ABSPOS 

BLDMSG 

BLDMSG/ BLDBUF 
BLDMSG/ REDOFF 
BVTIDS 

BVTIDS/BVTIFM 

B VT IDS/ CLRFLG 

BVTIDS/CVTIFM 

BVTIDS/ INSFLD 

BVTIDS/RVTIFM 

CLRMOD 

DEFFLD 

DEFWND 

DOSCR/ ERASE 

DOSCR/HSCR 

DOSCR/ VSCR 

DOSCREEN 

DRIVER/MAIN 

ERAWND 

FATAL 


VIRTUAL  TERMINAL  Module  List 
Purpose 

ABSOLUTIZE  CURSOR  POSITION  OF  FIELD 

BUILD  MESSAGE 

BUILD  BUFFER 

READ  FLAG  TURNED  OFF 

BUILD  VTI  DATA  STRUCTURE 

BUILD  VTI  FIELD  MAP 

CLEAR  FLAGS 

CLEAR  VTI  FIELD  MAP 

INSERT  FIELD 

REBUILD  VTI  FIELD  MAP 

CLEAR  MODIFY  FLAGS 

DEFINE  FIELD 

DEFINE  WINDOW 

ERASE  PART  OF  SCREEN 

HORIZONTAL  SCROLL 

VERTICAL  SCROLL 

DO  COMMAND  TO  INTERNAL  SCREEN 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

ERASE  WINDOW 

REPORT  FATAL  ERROR 
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Module  Name 

FNDWND 

GETVT 

GVTICMD 

INTVT 

INVIS 

PCHVT1 

PRCCMDS 

PUTVT 

PVTICMD 

PVTICMD/ PUTNUM 

REFRESH 

REFTERM 

RMVWND 

SL INEND 

STFMTF 

STRDPN 

STRDPN / STFDRD 
SWNPRC 
TPUTNUM 
TPUTS 


VIRTUAL  TERMINAL  Module  List 
Purpose 

FIND  WINDOW 

GET  DATA  FROM  VIRTUAL  TERMINAL 

GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 

INITIALIZE  VIRTUAL  TERMINAL 

CHECK  FOR  INVISIBILITY 

PUT  SCREEN  CHARACTERS  TO  VTI  DATA 
STRUCTURE 

PROCESS  COMMAND 

PUT  DATA  TO  VIRTUAL  TERMINAL 

PUT  VTI  COMMAND 

PUT  NUMBER 

REFRESH  TERMINAL 

REFRESH  TERMINAL 

REMOVE  WINDOW 

FIND  SCREEN  LINE  END 

SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS 
AND  FIELDS 

SET  READ  PENDING  FLAGS 
SET  FIELD  READ  PENDING 
SET  WINDOW  PRECEDENCE 
TERMINAL  PUT  NUMBER 
TERMINAL  PUT  STRING 
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VIRTUAL  TERMINAL  Module  List 
Module  Name  Purpose 


TRMCHK 

TRMEND 

TRMFLS 

TRMGET 

TRMINI 

TRMPUT 

TRMVT 

TVTPRC 

VT100/M0VCUR 


TERMINAL  CHECK 
TERMINAL  END 
TERMINAL  FLUSH 
TERMINAL  GET 
TERMINAL  INITIALIZE 
TERMINAL  PUT 

TERMINATE  VIRTUAL  TERMINAL 
TERMINATE  VTI  PROCESS 
MOVE  CURSOR  (INTERNAL) 

SET  ATTRIBUTES  (INTERNAL) 


VT 1 00 / SETATR 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10  6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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VIRTUAL  TERMINAL  External  Routines  List 


Module  Name 

First  User 

BLDCMD 

BVTIDS 

CABIT 

TRMPUT 

CALLOC 

DEFWND 

CBIT 

DOSCR/ERASE 

COL 

TRMPUT 

CSTR 

INTVT 

DELAY 

DRIVER/MAIN 

EXIT 

TVTPRC 

FCLOSE 

DRIVER/MAIN 

FFBDA 

TRMPUT 

FFBSA 

VT100/SETATR 

FFBSB 

DOSCREEN 

FIX 

DOSCREEN 

FLOOR 

DOSCREEN 

FOPEN 

DRIVER/MAIN 

FPRINTF 

DRIVER/MAIN 

FREE 

BVTIDS/ INSFLD 

FSEARCH 

DRIVER/MAIN 

FWRITE 

DRIVER/MAIN 

GETCHAR 

TRMPUT 

INITEX 

DRIVER/MAIN 

ISDIGIT 

TRMGET 

ISPRINT 

GVTICMD 

LIMIT 

DOSCREEN 

MALLOC 

BVTIDS/ INSFLD 

MAX 

PCHVTI 

MEMCMP 

DRIVER/MAIN 

MEMCPY 

DRIVER/MAIN 

MEMSET 

DEFFLD 

MIN 

DOSCR/VSCR 

NSEND 

DRIVER/MAIN 

POS 

TRMPUT 

PRINTF 

FATAL 

PRNEND 

TRMEND 

PRNFLS 

TRMPUT 

PRNINI 

TRMINI 

PRNPUT 

TRMPUT 

PUTC 

DRIVER/MAIN 

RCV 

DRIVER/MAIN 

ROW 

REFRESH 

SBIT 

DOSCR/VSCR 
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VIRTUAL  TERMINAL  External  Routines  List 


Module  Name 

First  User 

SIGNAL 

DRIVER/MAIN 

SPRINTF 

DRIVER/MAIN 

STRASN 

BVTIDS/CVTIFM 

STRCAT 

DRIVER/MAIN 

STROP Y 

DRIVER/MAIN 

STRLEN 

BLDMSG/ BLDBUF 

TBIT 

DOSCR/ERASE 

TBOPEN 

TRMINI 

TCHECK 

TRMCHK 

TCLOSE 

TRMEND 

TFLUSH 

TRMFLS 

TGETC 

TRMGET 

TOLOWER 

DRIVER/MAIN 

TPURGE 

TRMGET 

TPUTC 

VT 1 00 / SETATR 

TRMNAT 

DRIVER/MAIN 

ZERO 

DOSCREEN 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
i nc 1 ude  file. 

A  purpose  of  *****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***** 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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VIRTUAL  TERMINAL  Include  File  List 
File  Name  Purpose 


BITS  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

CI600.C"  *•**  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

CTLCHR  CONTROL  CHARACTERS 

CTYPE  PURPOSE  NOT  FOUND  BY  STRIPPER  **•* 

DEVICE  PHYSICAL  DEVICE  DATA  STRUCTURE 

DEV INI  DEVICE  INITIALIZATIONS 

FUNCTS  FUNCTION  DEFINITIONS 

NTM  NTM  INTERFACE  INCLUDE  FILE 

SCREEN  INTERNAL  SCREEN  DEFINITIONS 

SIGNAL  *•*»  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 

STDIO  PURPOSE  NOT  FOUND  BY  STRIPPER  *  *  *  * 

STDTYP  STANDARD  TYPE  DEFINITIONS 

TERM 10  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

TRMRTN  TERMINAL  (DEVICE  DRIVER)  ROUTINES 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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VIRTUAL  TERMINAL  Where- i nc lude-f i 1 e-used  List 

Include  Module  Module 

Pile  Name  Purpose 


BITS 

BLDMSG  BUILD  MESSAGE 
BLDMSG/BL  BUILD  BUFFER 
BLDMSG /RE  READ  FLAG  TURNED  OFF 
BVTIDS  BUILD  VTI  DATA  STRUCTURE 
BVTIDS/BV  BUILD  VTI  FIELD  MAP 
BVTIDS /CL  CLEAR  FLAGS 
BVTIDS/CV  CLEAR  VTI  FIELD  MAP 
BVTIDS/ IN  INSERT  FIELD 
BVTIDS/RV  REBUILD  VTI  FIELD  MAP 
CLRMOD  CLEAR  MODIFY  FLAGS 
DEFFLD  DEFINE  FIELD 
DEFWND  DEFINE  WINDOW 
DOSCR/ ERA  ERASE  PART  OF  SCREEN 
DOSCR/HSC  HORIZONTAL  SCROLL 
DOSCR/ V SC  VERTICAL  SCROLL 
DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 
DRIVER  MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

ERAWND  ERASE  WINDOW 

GETVT  GET  DATA  FROM  VIRTUAL  TERMINAL 

GVTICMD  GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 
INTVT  INITIALIZE  VIRTUAL  TERMINAL 

INVIS  CHECK  FOR  INVISIBILITY 

PCHVTI  PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

STRUCTURE 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

PVTICMD  PUT  VTI  COMMAND 

PVTICMD/P  PUT  NUMBER 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

RMVWND  REMOVE  WINDOW 

SLINEND  FIND  SCREEN  LINE  END 

STFMTF  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS 
AND  FIELDS 

SWNPRC  SET  WINDOW  PRECEDENCE 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 
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VIRTUAL  TERMINAL  Where- include-fi le-used  List 


Include  Module 
File  Name 


Module 

Purpose 


TRMGET  TERMINAL  GET 
TRMINI  TERMINAL  INITIALIZE 
TRMPUT  TERMINAL  PUT 
TRMVT  TERMINATE  VIRTUAL  TERMINAL 

VT 100 /MOV  MOVE  CURSOR  (INTERNAL) 

VT 100 /SET  SET  ATTRIBUTES  (INTERNAL) 


CI600.C- 


V 


TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 

TRMINI  TERMINAL  INITIALIZE 

TRMPUT  TERMINAL  PUT 

VT 1 00 / MOV  MOVE  CURSOR  (INTERNAL) 

VT 100 /SET  SET  ATTRIBUTES  (INTERNAL) 


CTLCHR 

BLDMSG  BUILD  MESSAGE 
BLDMSG/BL  BUILD  BUFFER 
BLDMSG/ RE  READ  FLAG  TURNED  OFF 

DRIVER/MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

GVTICMD  GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 
INTVT  INITIALIZE  VIRTUAL  TERMINAL 

PVTICMD  PUT  VTI  COMMAND 
PVTICMD/P  PUT  NUMBER 

TRMVT  TERMINATE  VIRTUAL  TERMINAL 


CTYPE 

DEFFLD  DEFINE  FIELD 
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VIRTUAL  TERMINAL  Where- l nc 1 ude  f i le-used  List 


Include  Module  Module 

File  Name  Purpose 


GVTICMD 

TRMCHK 

TRMEND 

TRMFLS 

TRMGET 

TRMINI 

TRMPUT 

VT 1 00 / MOV 

VTI  00  SET 


GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 

TERMINAL  CHECK 

TERMINAL  END 

TERMINAL  FLUSH 

TERMINAL  GET 

TERMINAL  INITIALIZE 

TERMINAL  PUT 

MOVE  CURSOR  (INTERNAL) 

SET  ATTRIBUTES  (INTERNAL) 


DEVICE 


ABSPOS 
BLDMSG 
BLDMSG/BL 
BLDMSG  RE 
BVTIDS 
BVTIDS/BV 
BVTIDS /CL 
BVTIDS / CV 
BVTIDS ' IN 
BVTIDS/ RV 
DEFFLD 
DEFWND 
DRIVER  MA 

ERAWND 

FNDWND 

GETVT 

PCHVTI 

PUTVT 

RMVWND 

STFMTF 

STRDPN 
STRDPN / ST 
SVNPRC 


ABSOLUTIZE  CURSOR  POSITION  OF  FIELD 

BUILD  MESSAGE 

BUILD  BUFFER 

READ  FLAG  TURNED  OFF 

BUILD  VTI  DATA  STRUCTURE 

BUILD  VTI  FIELD  MAP 

CLEAR  FLAGS 

CLEAR  VTI  FIELD  MAP 

INSERT  FIELD 

REBUILD  VTI  FIELD  MAP 

DEFINE  FIELD 

DEFINE  WINDOW 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

ERASE  WINDOW 
FIND  WINDOW 

GET  DATA  FROM  VIRTUAL  TERMINAL 
PUT  SCREEN  CHARACTERS  TO  VTI  DATA 
STRUCTURE 

PUT  DATA  TO  VIRTUAL  TERMINAL 
REMOVE  WINDOW 

SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS 
AND  FIELDS 

SET  READ  PENDING  FLAGS 
SET  FIELD  READ  PENDING 
SET  WINDOW  PRECEDENCE 
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VIRTUAL  TERMINAL  Where- include-fi le-used  List 


Inc  1 ude 
Fi  le 


Module 

Name 


Module 

Purpose 


DEVIN  I 

DRIVER  MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


FUNCTS 


BLDMSG 
BLDMSG  BL 
BLDMSG  RE 
BVTIDS 
BVTIDS  BV 
BVTIDS /CL 
BVTIDS /CV 
BVTIDS  IN 
BVTIDS/ RV 
DEFFLD 
DEFWND 
DOSCR/ERA 
DOSCR/HSC 
DOSCR/VSC 
DOSCREEN 
DRIVER/MA 

GETVT 

GVTICMD 

INTVT 

PCHVTI 

PRCCMDS 

PUTVT 

PVTICMD 

PVTICMDP 

REFRESH 

REFTERM 


BUILD  MESSAGE 

BUILD  BUFFER 

READ  FLAG  TURNED  OFF 

BUILD  VTI  DATA  STRUCTURE 

BUILD  VTI  FIELD  MAP 

CLEAR  FLAGS 

CLEAR  VTI  FIELD  MAP 

INSERT  FIELD 

REBUILD  VTI  FIELD  MAP 

DEFINE  FIELD 

DEFINE  WINDOW 

ERASE  PART  OF  SCREEN 

HORIZONTAL  SCROLL 

VERTICAL  SCROLL 

DO  COMMAND  TO  INTERNAL  SCREEN 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 

DRIVER 

GET  DATA  FROM  VIRTUAL  TERMINAL 

GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 

INITIALIZE  VIRTUAL  TERMINAL 

PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

STRUCTURE 

PROCESS  COMMAND 

PUT  DATA  TO  VIRTUAL  TERMINAL 

PUT  VTI  COMMAND 

PUT  NUMBER 

REFRESH  TERMINAL 

REFRESH  TERMINAL 
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I 

VIRTUAL  TERMINAL  Where- include-f i le-used  List 


Include 

File 


Module 

Name 


Modu  1  e 
Purpose 


STFMTF 

SWNPRC 

TRMCHK 

TRMEND 

TRMFLS 

TRMGET 

TRMINI 

TRMPUT 

TRMVT 

VTI  00  MOV 

VT 100 'SET 


SET 

AND 

SET 

TERM 

TERM 

TERM 

TERM 

TERM 

TERM 

TERM 

MOVE 

SET 


FORMAT  FLAG  FOR  ALL  CHILDREN 
FIELDS 

WINDOW  PRECEDENCE 

INAL  CHECK 

INAL  END 

INAL  FLUSH 

INAL  GET 

INAL  INITIALIZE 

INAL  PUT 

INATE  VIRTUAL  TERMINAL 
CURSOR  (INTERNAL) 

ATTRIBUTES  (INTERNAL) 


WINDOWS 


NTM 


DRIVER  MA 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


SCREEN 


BLDMSG 
BLDMSG  BI. 
BLDMSG  RE 
BVTIDS 
BVTIDS'BV 
BVTIDS /CL 
BVTIDS / CV 
BVTIDS/ IN 
BVTIDS 'RV 
CLRMOD 
DOSCR/ERA 
DOSCR  HSC 
DOSCR  VSC 
DOSCREEN 
DRIVER / MA 


BUILD  MESSAGE 

BUILD  BUFFER 

READ  FLAG  TURNED  OFF 

BUILD  VTI  DATA  STRUCTURE 

BUILD  VTI  FIELD  MAP 

CLEAR  FLAGS 

CLEAR  VTI  FIELD  MAP 

INSERT  FIELD 

REBUILD  VTI  FIELD  MAP 

CLEAR  MODIFY  FLAGS 

ERASE  PART  OF  SCREEN 

HORIZONTAL  SCROLL 

VERTICAL  SCROLL 

DO  COMMAND  TO  INTERNAL  SCREEN 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 

DRIVER 


PS  620144300 
1  November  1985 


VIRTUAL  TERMINAL  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


GETVT  GET  DATA  FROM  VIRTUAL  TERMINAL 

INTVT  INITIALIZE  VIRTUAL  TERMINAL 

INVIS  CHECK  FOR  INVISIBILITY 

PCHVTI  PUT  SCREEN  CHARACTERS  TO  VTI  DATA 
STRUCTURE 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

PVTICMD  PUT  VTI  COMMAND 

PVTICMD/P  PUT  NUMBER 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

SLINEND  FIND  SCREEN  LINE  END 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 

TRMINI  TERMINAL  INITIALIZE 

TRMPUT  TERMINAL  PUT 

TRMVT  TERMINATE  VIRTUAL  TERMINAL 

VTI 00 /MOV  MOVE  CURSOR  (INTERNAL) 

VTI 00 /SET  SET  ATTRIBUTES  (INTERNAL) 


SIGNAL 

DRIVER/MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


STD  10 

DRIVER/MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

FATAL  REPORT  FATAL  ERROR 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 
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if. 

$■  VIRTUAL 

TERMINAL  Where- include-f i le-used  List 

1  Include 

Module 

Module 

r!  File 

A  _ 

Name 

Purpose 

$ 

•  * 

TRMINI 

TERMINAL  INITIALIZE 

A 

TRMPUT 

TERMINAL  PUT 

1 

VT 100 /MOV 

MOVE  CURSOR  ( INTERNAL ) 

v 

* 

v 

VT 100 /SET 

SET  ATTRIBUTES  { INTERNAL ) 

V 

V 

i 

j  STDTYP 

ABSPOS 

ABSOLUTIZE  CURSOR  POSITION  OF  FIELD 

X' 

BLDMSG 

BUILD  MESSAGE 

> 

1“ 

BLDMSG/BL 

BUILD  BUFFER 

V.' 

BLDMSG/ RE 

READ  FLAG  TURNED  OFF 

BVTIDS 

BUILD  VTI  DATA  STRUCTURE 

BVTIDS/BV 

BUILD  VTI  FIELD  MAP 

r 

BVTIDS /CL 

CLEAR  FLAGS 

K 

BVTIDS/CV 

CLEAR  VTI  FIELD  MAP 

p 

BVTIDS/ IN 

INSERT  FIELD 

r. 

BVTIDS/RV 

REBUILD  VTI  FIELD  MAP 

£■ 

CLRMOD 

CLEAR  MODIFY  FLAGS 

1 

DEFFLD 

DEFINE  FIELD 

P 

DEFWND 

DEFINE  WINDOW 

DOSCR/ERA 

ERASE  PART  OF  SCREEN 

t- 

DOSCR/HSC 

HORIZONTAL  SCROLL 

K 

DOSCR/VSC 

VERTICAL  SCROLL 

a 

DOSCREEN 

DO  COMMAND  TO  INTERNAL  SCREEN 

1 

m 

■ 

DRIVER/MA 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 

DRIVER 

• 

L" 

ERAWND 

ERASE  WINDOW 

FATAL 

REPORT  FATAL  ERROR 

? 

FNDWND 

FIND  WINDOW 

fc 

GETVT 

GET  DATA  FROM  VIRTUAL  TERMINAL 

0 

GVTICMD 

GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 

F- 

INTVT 

INITIALIZE  VIRTUAL  TERMINAL 

f" 

INVIS 

CHECK  FOR  INVISIBILITY 

!•■ 

PCHVTI 

PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

r- 

r- 

STRUCTURE 

' 

PRCGMDS 

PROCESS  COMMAND 

PUTVT 

PUT  DATA  TO  VIRTUAL  TERMINAL 

c 

PVTICMD 

PUT  VTI  COMMAND 

| 

I 
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VIRTUAL  TERMINAL  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


PVTICMD/P  PUT  NUMBER 
REFRESH  REFRESH  TERMINAL 
REFTERM  REFRESH  TERMINAL 
RMVWND  REMOVE  WINDOW 
SLINEND  FIND  SCREEN  LINE  END 

STFMTF  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS 
AND  FIELDS 

STRDPN  SET  READ  PENDING  FLAGS 
STRDPN/ST  SET  FIELD  READ  PENDING 
SWNPRC  SET  WINDOW  PRECEDENCE 
TPUTNUM  TERMINAL  PUT  NUMBER 

TPUTS  TERMINAL  PUT  STRING 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 

TRMINI  TERMINAL  INITIALIZE 

TRMPUT  TERMINAL  PUT 

TRMVT  TERMINATE  VIRTUAL  TERMINAL 

TVTPRC  TERMINATE  VTI  PROCESS 
VT 100 /MOV  MOVE  CURSOR  (INTERNAL) 

VT100/SET  SET  ATTRIBUTES  (INTERNAL) 


TERMIO 

DRIVER/MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

TPUTNUM  TERMINAL  PUT  NUMBER 

TPUTS  TERMINAL  PUT  STRING 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 

TRMINI  TERMINAL  INITIALIZE 

TRMPUT  TERMINAL  PUT 

VTI 00 /MOV  MOVE  CURSOR  (INTERNAL) 
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VIRTUAL  TERMINAL  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


VT100/ SET  SET  ATTRIBUTES  (INTERNAL) 


TRMRTN 

DRIVER/ MA  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

GETVT  GET  DATA  FROM  VIRTUAL  TERMINAL 

INTVT  INITIALIZE  VIRTUAL  TERMINAL 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

TRMCHK  TERMINAL  CHECK 

TRMEND  TERMINAL  END 

TRMFLS  TERMINAL  FLUSH 

TRMGET  TERMINAL  GET 

TRMINI  TERMINAL  INITIALIZE 

TRMPUT  TERMINAL  PUT 

TRMVT  TERMINATE  VIRTUAL  TERMINAL 

VTIOO/MOV  MOVE  CURSOR  (INTERNAL) 

VT 1 00/ SET  SET  ATTRIBUTES  (INTERNAL) 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


BLDCMD 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

GETVT  GET  DATA  FROM  VIRTUAL  TERMINAL 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

TRMGET  TERMINAL  GET 


CAB  IT 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 
TRMPUT  TERMINAL  PUT 


C ALLOC 

DEFFLD  DEFINE  FIELD 

DEFWND  DEFINE  WINDOW 

DRIVER/ MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


GBIT 

CLRMOD  CLEAR  MODIFY  FLAGS 

DOSCR/ERASERASE  PART  OF  SCREEN 

DOSCR/ VSCRVERTICAL  SCROLL 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 


COL 

BLDMSG  BUILD  MESSAGE 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


DOSCR/ERASERASE  PART  OF  SCREEN 

DOSCR/HSCRHORIZONTAL  SCROLL 

DOSCR/ VSCRVERTICAL  SCROLL 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

PRCCMDS  PROCESS  COMMAND 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

SLINEND  FIND  SCREEN  LINE  END 

TRMGET  TERMINAL  GET 

TRMPUT  TERMINAL  PUT 

VT 1 00 / MOVCMOVE  CURSOR  (INTERNAL) 


CSTR 

INTVT  INITIALIZE  VIRTUAL  TERMINAL 


DELAY 

DRI VER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


EXIT 

DRI VER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

TVTPRC  TERMINATE  VTI  PROCESS 


FCLOSE 

DRI VER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


FFBDA 

TRMPUT  TERMINAL  PUT 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


FFBSA 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

TRMPUT  TERMINAL  PUT 

VT100/ SETASET  ATTRIBUTES  (INTERNAL) 


FFBSB 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 


FIX 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 


FLOOR 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 


FOPEN 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


FPRINTF 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


FREE 


BVT I DS / CVTCLEAR  VTI  FIELD  MAP 
BVTIDS / I NS INSERT  FIELD 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

ERAWND  ERASE  WINDOW 

INTVT  INITIALIZE  VIRTUAL  TERMINAL 

RMVWND  REMOVE  WINDOW 

TRMVT  TERMINATE  VIRTUAL  TERMINAL 


FSEARCH 

DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


F WRITE 

DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


GETCHAR 

TRMGET  TERMINAL  GET 
TRMPUT  TERMINAL  PUT 


INITEX 

DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


ISDIGIT 

GVTICMD  GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 
TRMGET  TERMINAL  GET 


ISPRINT 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


DEFFLD  DEFINE  FIELD 

GVTICMD  GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 
TRMGET  TERMINAL  GET 


LIMIT 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 


MALLOC 

BVTIDS/BVTBUILD  VTI  FIELD  MAP 
BVTIDS/CVTCLEAR  VTI  FIELD  MAP 
BVTIDS/ INSINSERT  FIELD 
DEFFLD  DEFINE  FIELD 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

INTVT  INITIALIZE  VIRTUAL  TERMINAL 


MAX 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 

BVTIDS/ INSINSERT  FIELD 
DEFWND  DEFINE  WINDOW 

DOSCR/ VSCRVERTICAL  SCROLL 
DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

PCHVTI  PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

STRUCTURE 

REFTERM  REFRESH  TERMINAL 


MEMCMP 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


MEMCPY 

BLDMSG  BUILD  MESSAGE 
BLDMSG / BLDBU I LD  BUFFER 

DRIVER/ MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


MEMSET 

DEFFLD  DEFINE  FIELD 


MIN 

BVTIDS/ INSINSERT  FIELD 
DEFWND  DEFINE  WINDOW 
DOSCR / HSCRHOR I ZONT AL  SCROLL 
DOSCR/VSCR VERTICAL  SCROLL 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

REFTERM  REFRESH  TERMINAL 


NSEND 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


POS 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 
TRMPUT  TERMINAL  PUT 


PRINTF 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


DRIVER  MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

FATAL  REPORT  FATAL  ERROR 

TRMGET  TERMINAL  GET 

TRMPUT  TERMINAL  PUT 


PRNEND 

TRMEND  TERMINAL  END 


PRNFLS 

TRMPUT  TERMINAL  PUT 


PRNINI 

TRMINI  TERMINAL  INITIALIZE 


PRNPUT 

TRMPUT  TERMINAL  PUT 


PUTC 

DRIVER/ MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


DRIVER 'MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


RCV 
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VIRTUAL  TERMINAL  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


ROW 

BLDMSG  BUILD  MESSAGE 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 

DOSCR  VSCRVERTICAL  SCROLL 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

PRCCMDS  PROCESS  COMMAND 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

TRMGET  TERMINAL  GET 

TRMPUT  TERMINAL  PUT 

VTI 00  MOVCMOVE  CURSOR  (INTERNAL) 


SBIT 

DOSCR  ERASERASE  PART  OF  SCREEN 

DOSCR  VSCRVERTICAL  SCROLL 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

TRMPUT  TERMINAL  PUT 


SIGNAL 

DRIVER  MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


SPRINTF 

BLDMSG  BUILD  MESSAGE 
BLDMSG /BLDBU I LD  BUFFER 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


STRASN 

BVTIDS  BUILD  VTI  DATA  STRUCTURE 
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VIRTUAL  TERMINAL  Where-externa 1 -rout i ne-used  List 


System 

Module 


Module 

Name 


Module 

Purpose 


BVT I DS / CVTCLE AR  VTI  FIELD  MAP 
BVTIDS ' INSINSERT  FIELD 
DOSCR/ERASERASE  PART  OF  SCREEN 


STRCAT 


STRCPY 


STRLEN 


DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


BLDMSG  BUILD  MESSAGE 
BLDMSG/BLDBUILD  BUFFER 

DRIVER/MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


DOSCR ' ERASERASE  PART  OF  SCREEN 
DOSCR/ HSCRHORI ZONTAL  SCROLL 
DOSCR /VSCRVERTICAL  SCROLL 
DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 
GETVT  GET  DATA  FROM  VIRTUAL  TERMINAL 

INVIS  CHECK  FOR  INVISIBILITY 

PCHVTI  PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

STRUCTURE 

PRCCMDS  PROCESS  COMMAND 

PUTVT  PUT  DATA  TO  VIRTUAL  TERMINAL 

REFRESH  REFRESH  TERMINAL 

REFTERM  REFRESH  TERMINAL 

TRMGET  TERMINAL  GET 
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System  Module  Module 

Module  Name  Purpose 


TRMPUT  TERMINAL  PUT 


TBOPEN 


TCHECK 


TRMINI  TERMINAL  INITIALIZE 


TRMCHK  TERMINAL  CHECK 


TCLOSE 


TRMEND  TERMINAL  END 


TFLUSH 


TRMFLS  TERMINAL  FLUSH 


TGETC 


TRMGET  TERMINAL  GET 


TOLOWER 


DRIVER  MAIMAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 


TPURGE 


TRMGET  TERMINAL  GET 
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VIRTUAL  TERMINAL  Where-external -rout i ne-used  List 


System 

Module 

Modu 1 e 
Name 

Module 

Purpose 

TPUTC 

TPUTNUM 

TERMINAL 

PUT 

NUMBER 

TPUTS 

TRMPUT 

TERMINAL 

TERMINAL 

PUT 

PUT 

STRING 

VT 1 00 / MOVCMOVE  CURSOR  (INTERNAL) 

VT 1 00/ SETA SET  ATTRIBUTES  (INTERNAL) 


TRMNAT 

DRIVER /MAI MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 
DRIVER 

TVTPRC  TERMINATE  VTI  PROCESS 


ZERO 

DOSCREEN  DO  COMMAND  TO  INTERNAL  SCREEN 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  "well-defined 
module"  appears  by  the  module  name ,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  wel 1 . 


3-39 


PS  620144300 
1  November  1985 


I 


VIRTUAL  TERMINAL  Main  Program  Paris  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

DRIVER  /  M.a  IN  Purpose- 

- > MAIN  MODULE  FOR  WINDOW  MANAGER 

AND  DEVICE  DRIVER 

ABSPOS 

Well-defined  module 

BLDCMD 

External  routine 

BLDMSG 

Well-defined  module 

BLDMSG/ BLDBUF 

Well-defined  module 

BLDMSG/ REDOFF 

Well-defined  module 

BVTIDS 

Well-defined  module 

BVTIDS/BVTIFM 

Well-defined  module 

BVTIDS/CLRFLG 

Well-defined  module 

BVTIDS/CVTIFM 

Well-defined  module 

BVTIDS/ INSFLD 

Well-defined  module 

BVTIDS/RVTIFM 

Well-defined  module 

CABIT 

External  routine 

CALLOC 

External  routine 

CBIT 

External  routine 

CLRMOD 

Well-defined  module 

COL 

External  routine 

CSTR 

External  routine 

DEFFLD 

Well-defined  module 

DEFWND 

Well-defined  module 

DELAY 

External  routine 

DOSCR/ERASE 

Well-defined  module 

DOSCR/HSCR 

Well-defined  module 

DOSCR/VSCR 

Well-defined  module 

DOSCREEN 

Well-defined  module 

ERAWND 

Well-defined  module 

EXIT 

External  routine 

FATAL 

Well-defined  module 

FCLOSE 

External  routine 

FFBDA 

External  routine 

FFBSA 

External  routine 

FFBSB 

External  routine 

FIX 

External  routine 

FLOOR 

External  routine 

FNDWND 

Well-defined  module 

FOPEN 

External  routine 

FPRINTF 

External  routine 

FREE 

External  routine 

FSEARCH 

External  routine 
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VIRTUAL  TERMINAL  Main 

Main  Pgm  Module 
Name  Name 


FWRITE 

GETCHAR 

GETVT 

GVTICMD 

INITEX 

INTVT 

INVIS 

ISDIGIT 

ISPRINT 

LIMIT 

MALLOC 

MAX 

MEMCMP 

MEMCPY 

MEMSET 

MIN 

NSEND 

PCHVTI 

POS 

PRCCMDS 

PRINTF 

PRNEND 

PRNFLS 

PRNINI 

PRNPUT 

PUTC 

PUTVT 

PVTICMD 

PVTICMD/PUTNUM 

RCV 

REFRESH 

REFTERM 

RMVWND 

ROW 

SBIT 

SIGNAL 

SLINEND 

SPRINTF 

STFMTF 

STRASN 


Program  Parts  List 

Module 

Type 


External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
Well-defined  module 
External  routine 
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STRCAT 

STRCPY 

STRDPN 

STRDPN/STFDRD 

STRLEN 

SWNPRC 

TBIT 

TBOPEN 

TCKECK 

TCLOSE 

TFLUSH 

TGETC 

TOLOWER 

TPURGE 

TPUTC 

TPUTNUM 

TPUTS 

TRMCHK 

trmend 

trmfls 

trmget 

TRMINI 

trmnat 

trmput 

TRMVT 

TVTPRC 

VT100/M0VCUR 

VT100/SETATR 

ZERO 


Program  Parts  List 

Modul  e 
Type 


External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well -def i ned  modu 1 e 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code. 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-l  Workbench  C) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program.  Subroutine,  or 

Function . 

SOURCE  FILE:  Name  of  Source  File  from  file 

specification . 

SOURCE  FILE  TYPE:  Source  File  Extension  from  file 

specification . 

HOST:  Whether  this  is  a  host -dependent 

routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

SUBSYSTEM:  IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY:  Sub-directory  of  that  subsystem  in 

which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION: 


A  description  of  the  module  as  otained 
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from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 

INCLULE  .'iiiES:  A  list  of  all  the  file-  that  are 

included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ABSPOS 

ABSOLUTIZE  CURSOR 
C 

SUBROUTINE 
VOID  () 

ABSPOS 

.C 

UI 

DRIVER 

VIRTERM 


POSITION  OF  FIELD 


SYNOPSIS 

VOID  ABSPOS ( WNDPTR , ACRPOS ) 
WND  * WNDPTR; 

POSITION  * ACRPOS; 


INPUTS /OUTPUTS: 


INPUTS  : 

WNDPTR  -  WINDOW  WHOSE  ROW  AND  COL  WANT  TO  ABSOLUTIZED 
ADDRESS  OF  STURCTURE  FOR  RETURNING  VALUES  OF: 


ROW 


ABSOLUTE 


COL 


OUTPUTS : 
STRUCTURE 


CONTAINING: 

ABSOLUTE  ROW  OF  FIELD 
ABSOLUTE  COL  OF  FIELD 


ABSOLUTE 


DESCRIPTION 

THIS  MODULE  ABSOLUTIZES  A  FIELD'S  ROW  AND  COL  BY  GOING 

BACK  UP 

CHILD  PARENT  TREE  AND  ADDING  EACH  SUCCESSIVE  PARENT'S  ROW 

AND  COL 

TO  SUM  OF  CHILDS' . 
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ARGUMENTS : 


WNDPTR  -  WND  * 

ACRPOS  -  POSITION  * 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


CALLED  DIRECTLY  BY: 


BVTIDS  -  BUILD  VTI  DATA  STRUCTURE 

PCHVTI  -  PUT  SCREEN  CHARACTERS  TO  VTI  DATA  STRUCTURE 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME :  BLDMSG 

PURPOSE :  BUILD  MESSAGE 

LANGUAGE :  C 

MODULE  TYPE :  SUBROUTINE 

FUNCTION  TYPE:  VOID  () 

SOURCE  FILE:  BLDMSG 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION: 


SYNOPSIS 

VOID  BLDMSG (BUFF ,  MAXLEN ,  LEN) 
CHAR  BUFF [ ] ; 

I NT  MAXLEN ; 

INT  *LEN ; 


INPUTS/OUTPUTS: 


INPUTS : 

ADDRESS  OF  BUFF  WHERE  FORMATED  MESSAGE  TO  BE  PUT 
MAXLEN  -  LENGTH  OF  THIS  MEMORY  AREA 

ADDRESS  OF  LOCATION  WHERE  LEN  OF  THIS  FORMATTED  MESSAGE 
TO  BE  PUT 

OUTPUTS : 

BUFF  -  CONTAINES  FORMATED  MESSAGE 
LEN  -  CONTAINES  LENGTH  OF  THIS  FORMATED  MESSAGE 
DESCRIPTION 

THIS  MODULE  BUILDS  A  FORMATED  MESSAGE(TO  BE  SENT  ACROSS 

NTM  TO  MONITOR) 

ARGUMENTS : 


BUFF  -  CHAR  [ ] 

MAXLEN  =  INT 

LEN  =  INT  • 
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INCLUDE  FILES: 


STDTYP 

BITS 

SCREEN 

FUNCTS 

CTLCHR 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

CONTROL  CHARACTERS 

PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


ROW 

COL 

BLDMSG/BLDBUF  -  BUILD  BUFFER 

SPRINTF 

STRLEN 

MEMCPY 

BLDMSG/ REDOFF  -  READ  FLAG  TURNED  OFF 
BVTIDS  -  BUILD  VTI  DATA  STRUCTURE 


CALLED  DIRECTLY  BY: 

GETVT  -  GET  DATA  FROM  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP. 


BLDMSG/ BLDBUF 
BUILD  BUFFER 
C 

SUBROUTINE 
VOID  (  ) 

BLDMSG 

-C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION : 


SYNOPSIS 

STATIC  VOID  BLDBUF (WNDPT,  BUFPTR ,  BUFEND) 
REGISTER  WND  *  WNDPT ; 

REGISTER  CHAR  * ’BUFPTR ; 

CHAR  ‘BUFEND; 

INPUTS /OUTPUTS: 


INPUTS  : 
WNDPT 

BUFPTR 

BUFEND 


POINTER  TO  WINDOW  FROM  WHICH  TO  GET  INFO  TO 
PUT  IN  MESSAGE 

ADDRESS  OF  POINTER  WHERE  FORMATED  MESSAGE  TO 
BE  PUT 

END  OF  THIS  MEMORY  AREA 


OUTPUTS : 

BUFPTR  -  POINTS  TO  LAST  ENTERY  OF  FORMATED  MESSAGE 


DESCRIPTION 

THIS  MODULE  BUILDS  A  FORMATED  MESSAGEC TO  BE  SENT  ACROSS 

NTM  TO  MONITOR) 

FROM  WINDOW  POINTED  TO  BY  WNDPT 


ARGUMENTS : 


WNDPT  = 
BUFPTR  - 
BUFEND  = 


WND  * 
CHAR  •• 
CHAR  • 


/  .»  V 
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INCLUDE  FILES 

STDTYP 

BITS 

SCREEN 

FUNCTS 

CTLCHR 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

CONTROL  CHARACTERS 

PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 

BLDMSG / BLDBUF  -  BUILD  BUFFER 

MEMCPY 

STRLEN 

SPRINTF 


CALLED  DIRECTLY  BY: 

BLDMSG/ BLDBUF  -  BUILD  BUFFER 
BLDMSG  -  BUILD  MESSAGE 


USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME:  BLDMSG/F 

PURPOSE :  READ  FL/ 

LANGUAGE :  C 

MODULE  TYPE:  SUBROUT] 

FUNCTION  TYPE:  VOID  () 

SOURCE  FILE:  BLDMSG 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 


BLDMSG /REDOFF 

READ  FLAG  TURNED  OFF 

C 

SUBROUTINE 
VOID  () 

BLDMSG 

-C 

UI 

DRIVER 


DESCRIPTION: 

SYNOPSIS 

STATIC  VOID  REDOFF (WNDPT) 
REGISTER  WND  ‘WNDPT; 


IN PUTS /OUTPUTS : 


INPUTS : 

WNDPT  -  POINTER  TO  WINDOW  FROM  WHICH  DATA  WAS  READ 

OUTPUTS : 

NONE 

DESCRIPTION 

THIS  MODULE  TURNS  OFF  ALL  READ  FLAGS  OF  CHILD  WINDOWS  AND 

FIELDS  WHOSE 

DATA  HAS  BEEN  PUT  IN  FORMATED  MESSAGE( TO  BE  SENT  ACROSS 

NTM  TO  MONITOR) 

OF  WINDOW  POINTED  TO  BY  WNDPT 


ARGUMENTS 


WNDPT 


INCLUDE  FILES 


STDTYF 

BITS 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 


‘  1 


3-51 


PS  620144300 
1  November  1985 


SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

FUNCTS  -  FUNCTION  DEFINITIONS 

CTLCHR  -  CONTROL  CHARACTERS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


BLDMSG/ REDOFF  -  READ  FLAG  TURNED  OFF 


CALLED  DIRECTLY  BY: 


BLDMSG/ REDOFF  -  READ  FLAG  TURNED  OFF 
BLDMSG  -  BUILD  MESSAGE 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION : 


SYNOPSIS 

BOOL  BVTIDS (  ) 


INPUTS /OUTPUTS : 


INPUTS : 

NONE 

OUTPUTS : 

RETURNS  SUCCESS/FAILURE 
DESCRIPTION 

THIS  MODULE  (AND  STATIC  SUBMODULES)  BUILDS  THE  VTI  FIELD 

MAP  USED  BY 

VIRTUAL  TERMINAL  TO  PAINT  SCREEN  ON  TERMINAL( DEVICE )  FROM 

THE  INTERNAL 

DATA  STRUCTURE. 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


BVTIDS 

BUILD  VTI  DATA  STRUCTURE 
C 

FUNCTION 
BOOL  ( ) 

BVTIDS 

C 

UI 

DRIVER 
:  VIRTERM 


PS  620144300 
1  November  1985 


ROUTINES  CALLED: 


BLDCMD 

PRCCMDS  -  PROCESS  COMMAND 

BVT IDS/ CLRFLG  -  CLEAR  FLAGS 
ROW 
COL 

ABSPOS  -  ABSOLUTIZE  CURSOR  POSITION  OF  FIELD 

MAX 

STRASN 

MEMCMP 

BVTIDS/RVTIFM  -  REBUILD  VTI  FIELD  MAP 


CALLED  DIRECTLY  BY: 


BLDMSG  -  BUILD  MESSAGE 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/ MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


BVTIDS/BVTIFM 
BUILD  VTI  FIELD  MAP 
C 

FUNCTION 
BOOL  (  ) 

BVTIDS 

.C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION : 


DESCRIPTION 

TRAVERSES  THE  INTERNAL  STRUCTURE  ADDING  WINDOWS  AND 

FIELDS  TO  THE 

FIELD  MAP 
ARGUMENTS : 


WNDPT  =  WND  * 

BNI  =  INT  [] 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 
PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


BVTIDS/BVTIFM  -  BUILD  VTI  FIELD  MAP 
BVTIDS/ I NSFLD  -  INSERT  FIELD 
MALLOC 


CALLED  DIRECTLY  BY: 
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BVTIDS/RVTIFM  -  REBUILD  VTI  FIELD  MAP 
BVTIDS/BVTIFM  -  BUILD  VTI  FIELD  MAP 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/ MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


B VT IDS/ CLRFLG 
CLEAR  FLAGS 
C 

SUBROUTINE 
VOID  (  ) 

BVTIDS 

.C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION: 


DESCRIPTION 

THIS  MODULE  CLEARS  ALL  FORMAT  CHANGE  AND  CHANGE  OUTPUT 

FLAGS 


ARGUMENTS : 


WNDPT  «  WND  * 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 
PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


BVTIDS /CLRFLG  -  CLEAR  FLAGS 


CALLED  DIRECTLY  BY: 


BVTIDS /CLRFLG  -  CLEAR  FLAGS 

BVTIDS  -  BUILD  VTI  DATA  STRUCTURE 
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USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


BVTIDS/CVTIFM 
CLEAR  VTI  FIELD  MAP 
C 

FUNCTION 
BOOL  (  ) 

BVTIDS 

.C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 

REMOVES  ALL  OLD  VTI  FIELDS  FROM  THE  MAP  AND  FREES  THEM 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 
PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


STRASN 

MALLOC 

FREE 


CALLED  DIRECTLY  BY: 

BVTIDS/RVTIFM  -  REBUILD  VTI  FIELD  MAP 

USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


BVTIDS/ INSFLD 
INSERT  FIELD 
C 

FUNCTION 
BOOL  () 

BVTIDS 

.C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION : 


DESCRIPTION 

INSERTS  A  FIELD  (OR  WINDOW)  INTO  THE  FIELD  MAP  TAKING 

CARE  TO  TRUNCATE, 

SPLIT,  ORREMOVE  FIELDS  ALREADY  IN  THE  FIELD  MAP  WHICH  ARE 

PARTIALLY  OR 

TOTALLY  OBSCURED  BY  THE  NEW  FIELD.  NOTE  THAT  THIS 

ASSUMES  FIELDS  ARE 
INSERTED  IN  A  BACK-TO-FRONT  ORDER. 


ARGUMENTS : 


IVTIPT  =  VTIFLD  * 

WBNDRY  =  INT  [ ] 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 
PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


STRASN 

MALLOC 
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MIN 

MAX 

CALLED  DIRECTLY  BY: 

BVTIDS/BVTIFM  -  BUILD  VTI  FIELD  MAP 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE. 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


BVTIDS/RVTIFM 
REBUILD  VTI  FIELD  HAP 
C 

FUNCTION 
BOOL  (  ) 

BVTIDS 

.C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 

REBUILD  VTI  FIELD  MAP 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


BVTIDS /BVTIFM  -  BUILD  VTI  FIELD  MAP 
BVTIDS/CVTIFM  -  CLEAR  VTI  FIELD  MAP 


CALLED  DIRECTLY  BY: 


BVTIDS  -  BUILD  VTI  DATA  STRUCTURE 

USED  IN  MAIN  PROGRAM! S  )  : 


DRIVER  MAI  - 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


CLRMOD 

CLEAR  MODIFY  FLAGS 
C 

SUBROUTINE 
VOID  (  ) 

CLRMOD 

C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  CLRMOD( ) 

DESCRIPTION 

CLEARS  ALL  THE  MODIFY  FLAGS  IN  THE  INTERNAL  SCREEN 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED 


CBIT 


CALLED  DIRECTLY  BY: 


GETVT  -  GET  DATA  FROM  VIRTUAL  TERMINAL 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION 


Module  Documentation 


DEFFLD 

DEFINE  FIELD 
C 

FUNCTION 
BOOL  (  ) 
DEFFLD 
.C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

BOOL  DEFFLD(CMD.PTR) 
STRUCT  COMMAND  *  CMD ; 
CHAR  • PTR ; 


INPUTS  OUTPUTS 


INPUTS 

CMI  ADDRESS  OF  COMMAND  STRUCTURE  USED  TO  MODIFY  DATA 
STRUCTURE 

FTP  POINTS  TO  END  OF  MESSAGE  BUFFER  BEING  PROCESSED 


OUTPUTS 

PTR  WILL  POINT  TO  END  PROCESSED  DATA  IN  BUFFER 

RETURNS  SUCCESS  FAILURE 

LFSCP I PTION 

THIS  MODULE  USING  DATA  IN  COMMAND  STRUCTURE  AS  WELL  AS 

DATA  STILL  IN 

HE  .:,AGE  BUFFER  MODIFIES  INTERNAL  DATA  STRUCTURE  OF  FIELD 

SPECIFIED  BY 

•■•GST  WNDOW  AND  ROW  AND  COL  OF  FIELD  FIELD  BEING  DEFINED 

IF  NO  FIELD 

POUND  TO  MODIFY  THEN  ONE  IS  CREATED. 

ARGUME  N'l 
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CMD  -  STRUCT  COMMAND  * 

PTR  =  CHAR  *  • 


INCLUDE  FILES: 


STDTYP 

CTYPE 

BITS 

FUNCTS 

DEVICE 


STANDARD  TYPE  DEFINITIONS 

**»*  PURPOSE  NOT  FOUND  BY  STRIPPER  *•** 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTION  DEFINITIONS 

PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


CALLOC 

MALLOC 

MEMSET 

ISPRINT 


CALLED  DIRECTLY  BY: 


PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM! S ) : 


DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
PUNGTiON  TYPE 
SOURCE  PILE 
SOURCE  PILE  TYPE 
HOST 

SUBSYSTEM 

SUBDIRECTORY 

DGC'U M  ENT'AT  I  ON  GROUP 

i'ESCR  I  PTION 


i  N '  ’P’S  I  s 

BOOL  DEPWND(CMD) 

STRUCT  COMMAND  *CMD. 


DEFWND 

DEFINE  WINDOW 

C 

FUNCTION 
BOOL  (  ) 

DEFWND 

C 

UI 

DRIVER 

VIRTERM 


INPUTS  OUTPUTS 


I  N  ► 

'■  m;  ADDRESS  OP  COMMAND  STRUCTURE  USED  TO  MODIFY  DATA 
STRUCTURE 


RETURNS  SUCCESS  FAILURE 
LP.  SCR  1  I  I  1  ON 

PHD  MODULE  USING  DATA  IN  COMMAND  STRUCTURE  MODIFIES 

INTERNAL  DATA 

TP’;  "DO  K  OF  WINDOW  SPECIFIED  BY  CURENT  WNDOW  AND  WNDID 
OF  WINDOW 

•r  NO  PEP  i  N  E :  IF  no  window  is  found  TO  MODIFY  then  one 

IS  CREATED 


< :  y 


STRUCT  COMMAND  1 
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INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


FNDWND  -  FIND  WINDOW 

CALLOC 

MAX 

MIN 

STFMTF  -  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS  AND 

FIELDS 


CALLED  DIRECTLY  BY: 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  . 

PURPOSE : 

LANGUAGE 
MODULE  TYPE : 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM  : 
SUBDIRECTORY . 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


ARGUMENTS : 


LG  ~  INT 

HI  -  I NT 


DOSCR/ERASE 

ERASE  PART  OF  SCREEN 

C 

SUBROUTINE 
VOID  (  ) 

DOSCR 

.C 

UI 

DRIVER 

VIRTERM 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 


fi  l.'S  CALLED 


'SLY  BY 


HOR I ZONTAL  SCROLL 

VERTICAL  SCROLL 

!  *  i  COMMAND  TO  INTERNAL  SCREEN 
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USED  IN  MAIN  PROGRAM ( S  )  : 


DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


Vw 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME:  DOSCR/H! 

PURPOSE  HORIZON1; 

LANGUAGE  C 

MODULE  TYPE:  SUBROUT; 

FUNCTION  TYPE:  VOID  () 

SOURCE  PILE  DOSCR 

SOURCE  FILE  TYPE :  .  C 

HOST  : 

SUBSYSTEM  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 


DOSCR/HSCR 
HORIZONTAL  SCROLL 
C 

SUBROUTINE 
VOID  ( ) 

DOSCR 
.  C 

UI 

DRIVER 


DESCRIPTION 


ARGUMENTS 


DIR  = 
N  = 


INT 
I  NT 
INT  * 


INCLUDE  FILES: 

STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED: 

DOSCR  ERASE  -  ERASE  PART  OF  SCREEN 
MIN 

COL 

TBIT 


CALLED  DIRECTLY  BY: 


DO  SCREEN 


DO  COMMAND  TO  INTERNAL  SCREEN 
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USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/ MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


PS  620144300 
1  November  1985 
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£ 


i.'.- 

v\ 

v;. 

I 

»  ", 

■v' 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST  : 

SUBSYSTEM : 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION : 


DOSCR/VSCR 
VERTICAL  SCROLL 
C 

SUBROUTINE 
VOID  ( ) 

DOSCR 

.C 

UI 

DRIVER 


ARGUMENTS 

POS  = 

N  = 


I  NT 
I  NT 


INCLUDE  FILES: 

STDTYP 

BITS 

FUNCTS 

SCREEN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED: 

SBIT 

MAX 

DOSCR/ERASE 
ROW 
MIN 
COL 
CBIT 
TBIT 


ERASE  PART  OF  SCREEN 


CALLED  DIRECTLY  BY: 
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DOSCREEN  -  DO  COMMAND  TO  INTERNAL  SCREEN 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE : 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


DOSCREEN 

DO  COMMAND  TO  INTERNAL  SCREEN 
C 

FUNCTION 
INT  (  ) 

DOSCR 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION : 


SYNOPSIS 

INT  DOSCREEN ( CMD ) 

STRUCT  COMMAND  ‘CMD; 

DESCRIPTION 

EXECUTES  CMD  ON  THE  INTERNAL  SCREEN  AND  FIXES  UP  ITS 

PARAMETERS . 

RETURNS  -1  FOR  ERRORS,  0  FOR  NO  ACTION,  1  FOR  NORMAL 

COMMAND,  AND  2  FOR 
MOVE  THE  CURSOR  AND  RETRY. 

ARGUMENTS : 


CMD  =  STRUCT  COMMAND  * 


INCLUDE  FILES: 


STDTYP 

BITS 

FUNCTS 

SCREEN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED: 


TBIT 

CBIT 
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FFBSA 

DOSCR/HSCR  -  HORIZONTAL  SCROLL 

COL 

MAX 

FFBSB 

ROW 

DOSCR/VSCR  -  VERTICAL  SCROLL 

DOSCR/ ERASE  -  ERASE  PART  OF  SCREEN 

FIX 

LIMIT 

POS 

CABIT 

FLOOR 

SBIT 

ZERO 


CALLED  DIRECTLY  BY: 


PRCCMDS  -  PROCESS  COMMAND 

TRMGET  -  TERMINAL  GET 


USED  IN  MAIN  PROGRAM ( S ) 


DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE : 
FUNCTION  TYPE: 
SOURCE  FILE. 
SOURCE  FILE  TYPE: 
HOST  : 


DRIVER/MAIN 

MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 

DRIVER 

C 

FUNCTION 
INT  (  ) 

DRIVER 

C 


SUBSYSTEM:  UI 

SUBDIRECTORY:  DEVDRV 

DOCUMENTATION  GROUP:  VIRTERM 


DESCRIPTION : 


SYNOPSIS 
KAIN(  ) 


DESCRIPTION 

THIS  IS  THE  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE 

DRIVER.  IT  SITS 

IN  A  POOLING  LOOP  GETTING  MESSAGES  FOM  NTN  AND  PROCESSING 

THEM  AND 

GETTING  TERMINAL  INPUT  AND  PROCESSING  THAT.  WHEN  RUN, 

THREE  OPTIONAL 

ARGUMENTS  MAY  BE  SPECIFIED  FOR  SCRIPTING:  -W«FILE>  TO 

WRITE  A  SCRIPT 

FILE.  -R  < FILE  >  TO  READ  A  SCRIPT  FILE,  AND  ~S.FILE>  TO 

SAVE  OUTPUT  IN  A 


FILE  . 


ARGUMENTS : 


ARGC  =  INT 

ARGV  =  CHAR  *  [ ] 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

STDIO  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **“ 

TERMIO  -  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 
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DEVICE 

DEV INI 

NTM 

BITS 

FUNCTS 

SCREEN 

CTLCHR 

SIGNAL 

TRMRTN 


PHYSICAL  DEVICE  DATA  STRUCTURE 
DEVICE  INITIALIZATIONS 
NTM  INTERFACE  INCLUDE  FILE 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
INTERNAL  SCREEN  DEFINITIONS 
CONTROL  CHARACTERS 

*»«*  PURPOSE  NOT  FOUND  BY  STRIPPER 
TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED: 


BLDCMD 

TVTPRC 

INITEX 

MEMCMP 

PUTVT 

FPRINTF 

PRINTF 

TRMNAT 

EXIT 

INTVT 

CALLOC 

MALLOC 

FATAL 

DELAY 

TRMVT 

RCV 

TRMCHK 

GETVT 

SIGNAL 

MEMCPY 

STRCPY 

FREE 

STRCAT 

SPRINTF 

STRLEN 

NSEND 

FWRITE 

MIN 

PUTC 

FCLOSE 

FSEARCH 

FOPEN 

PRCCMDS 

TOLOWER 


TERMINATE  VTI  PROCESS 

PUT  DATA  TO  VIRTUAL  TERMINAL 


INITIALIZE  VIRTUAL  TERMINAL 

REPORT  FATAL  ERROR 
TERMINATE  VIRTUAL  TERMINAL 
TERMINAL  CHECK 

GET  DATA  FROM  VIRTUAL  TERMINAL 


PROCESS  COMMAND 
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NAME  : 

PURPOSE : 

LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM 
SUBDIRECTORY : 


ERAWND 

ERASE  WINDOW 

C 

SUBROUTINE 
VOID  ( ) 
ERAWND 
C 

UI 

DRIVER 


DOCUMENTATION  GROUP:  VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  ERAWNDC  WNDPT ) 
WND  ’WNDPT; 


INPUTS  OUTPUTS 


INPUTS 

WNDPT  -  POINTER  TO  WINDOW  WISH  TO  FREE 

OUTPUTS : 

NONE 

DESCRIPTION 

THIS  MODULE  FREES  ALL  WINDOW’S  CHILDREN  WINDOWS  AS  WELL 

AS  ALL 

DEPENDENT  FIELDS 
ARGUMENTS : 


WNDPT 


INCLUDE  FILES 

STDTYP 

BITS 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
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DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 

ROUTINES  CALLED 

ERAWND  -  ERASE  WINDOW 

FREE 

CALLED  DIRECTLY  BY: 


ERAWND  -  ERASE  WINDOW 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

RMVWND  -  REMOVE  WINDOW 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE 
SOURCE  FILE 
SOURCE  E 1 LE  TYPE. 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 

DESCRIPTION 


FATAL 

REPORT  FATAL  ERROR 

C 

SUBROUTINE 
VOID  (  ) 

FATAL 
.  C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  FATAL! MSG ) 

CHAR  MSG [ ] ; 

INPUTS 

MSG  -  ERROR  MESSAGE  TO  BE  DISPLAYED  (ERROR  -  %S\N) 


DESCRIPTION 

DISPLAYS  THE  SPECIFIED  ERROR  MESSAGE  AND  EXITS. 
ARGUMENTS 

MSG  -  CHAR  [  ] 

INCLUDE  FILES 

STDTYP  STANDARD  TYPE  DEFINITIONS 

STD I O  •••*  PURPOSE  NOT  FOUND  bY  STRIPPER  ’*** 


ROUTINES  CALLED 


TVTPRC  TERMINATE  VTI  PROCESS 

PRINTE 
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CALLED  DIRECTLY  BY: 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 

USED  IN  MAIN  PROGRAM ( S  )  : 


DRIVER  MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


SYNOPSIS 

WND  *  FNDWND( WNDID , FWNDPT ) 
REGISTER  INT  WNDID; 
REGISTER  WND  * FWNDPT; 


INPUTS/OUTPUTS : 


INPUTS : 

WNDID  -  ID  OF  WINDOW  SEARCHING  FOR 

FWNDPT  -  POINTER  TO  FIRST  WNDOW  IN  LIST  TO  BE  SEARCHED 
OUTPUTS : 

RETURNS  A  POINTER  TO  WINDOW  FOUND  OR  A  NULL 
DESCRIPTION 

THIS  MODULE  SEARCHES  FOR  A  WNDOW  WITH  THE  ID  GIVEN  AND 
EITHER  RETURNS 

A  POINTER  TO  THE  WINDOW  FOUND  OR  A  NULL. 

ARGUMENTS : 


WNDID  =  INT 

FWNDPT  =  WND  * 


INCLUDE  FILES : 

> 

) 


FNDWND 
FIND  WINDOW 
C 

FUNCTION 
WND  *  ( ) 
FNDWND 
-C 

UI 

DRIVER 
:  VIRTERM 
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STDTYP  -  STANDARD  TYPE  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


FNDWND  -  FIND  WINDOW 


CALLED  DIRECTLY  BY: 


DEFWND  -  DEFINE  WINDOW 

FNDWND  -  FIND  WINDOW 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

RMVWND  -  REMOVE  WINDOW 


USED  IN  MAIN  PROGRAM(S): 


DRIVER/ MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION : 


Module  Documentation 


GETVT 

GET  DATA  FROM  VIRTUAL  TERMINAL 
C 

SUBROUTINE 
VOID  (  ) 

GETVT 

C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  GETVT ( BUFF ,  MAXLEN ,  LEN ) 
CHAR  *  BUFF ; 

I NT  ‘MAXLEN,  *  LEN ; 


DESCRIPTION 

PERFORMS  A  READ  FROM  THE  VIRTUAL  TERMINAL  IF  IN  FORMS 

MODE.  BUFF 

WILL  CONTAIN  A  FORMATTED  SCREEN,  OTHERWISE  IT  WILL 

CONSIST  OF  ALL  THE 

PRINTABLE  CHARACTERS  ENTERED  PRIOR  TO  A  COMMAND;  IF  IN 

CONTROL  TRANSFER 

MODE.  THE  COMMAND  WILL  ALSO  BE  STORED  MAXLEN  IS  THE 

LENGTH  OF  BUFF. 

LEN  IS  THE  NUMBER  OF  CHARACTER  READ  IN 
ARGUMENTS 


BUFF  =  CHAR  * 

MAXLEN  I  NT  * 

LEN  =  I NT  * 


INCLUDE  FILES 


STDTY P 

BITS 

FUNCTS 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
FUNCTION  DEFINITIONS 
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SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 

TRMRTN  -  TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED: 


BLDCMD 

CLRMOD 

TBIT 

PVTICMD 

TRMGET 

PCHVTI 

BLDMSG 


CLEAR  MODIFY  FLAGS 

PUT  VTI  COMMAND 
TERMINAL  GET 

PUT  SCREEN  CHARACTERS  TO  VTI  DATA  STRUCTURE 
BUILD  MESSAGE 


CALLED  DIRECTLY  BY: 

DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER 'MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


PS  620144300 
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VIRTUAL  TERMINAL 


Module  Documentation 


NAME: 

PURPOSE 
LANGUAGE 
MODULE  TYPE: 
FUNCTION  TYPE 
SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST: 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


GVTICMD 

GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 
C 

SUBROUTINE 
VOID  (  ) 

GVTICMD 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  GVTICMD( CMD .  PTR .  END) 

STRUCT  COMMAND  *CMD; 

CHAR  *  *  PTR .  »  END ; 

DESCRIPTION 

PARSES  THE  NEXT  VIRTUAL  TERMINAL  COMMAND  INTO  CMD  AND 

UPDATES  PTR  TO 

POINT  TO  THE  CHARACTER  FOLLOWING  IT.  END  IS  A  POINTER  TO 

THE  CHARACTER 

FOLLOWING  THE  END  OF  THE  COMMAND  STRING 
ARGUMENTS 

CMD  -  STRUCT  COMMAND  * 

PTR  =  CHAR  *  • 

END  -  CHAR  • 


INCLUDE  FILES 


STDTYP 

CTYPE 

BITS 

FUNCTS 

CTLCHR 


STANDARD  TYPE  DEFINITIONS 

••••  PURPOSE  NOT  FOUND  BY  STRIPPER  •••• 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTION  DEFINITIONS 

CONTROL  CHARACTERS 
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ROUTINES  CALLED: 


ISPRINT 

ISDIGIT 


CALLED  DIRECTLY  BY: 


PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


INTVT 

INITIALIZE  VIRTUAL  TERMINAL 
C 

SUBROUTINE 
VOID  (  ) 

INTVT 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION : 


SYNOPSIS 

VOID  INTVT( TNAME .  LEN ) 

CHAR  * TNAME; 

INT  *  LEN ; 

DESCRIPTION 

OPENS  THE  VTI  FOR  THE  TERMINAL  SPECIFIED  BY  TNAME.  LEN 

IS  THE  NUMBER  OF 
CHARACTERS  IN  TNAME. 

ARGUMENTS 


TNAME  =  CHAR  • 

LEN  =  INT  * 


INCLUDE  FILES 


STDTYP 

BITS 

SCREEN 

FUNCTS 

CTLCHR 

TRMRTN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
INTERNAL  SCREEN  DEFINITIONS 
FUNCTION  DEFINITIONS 
CONTROL  CHARACTERS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED 
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CSTR 

MALLOC 

FREE 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

TRMINI  -  TERMINAL  INITIALIZE 


CALLED  DIRECTLY  BY: 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


INVIS 

CHECK  FOR  INVISIBILITY 
C 

FUNCTION 
BOOL  () 

INVIS 

-C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

BOOL  INVIS ( POS ) 

I NT  POS; 

DESCRIPTION 

RETURNS  TRUE  IF  THE  CHARACTER  AT  POSITION  POS  ON  THE 

INTERNAL  SCREEN 
IS  INVISIBLE.  FALSE  OTHERWISE. 

ARGUMENTS : 


POS  -  I NT 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED: 


TBIT 


CALLED  DIRECTLY  BY: 
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REFRESH  -  REFRESH  TERMINAL 

SLINEND  -  FIND  SCREEN  LINE  END 


USED  IN  MAIN  PROGRAM(S) 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


3-91 


> A*  f/V 


PS  620144300 
1  November  1985 


VIRTUAL  TERMINAL  Module  Documentation 


NAME:  PCHVTI 

PURPOSE:  PUT  SCREEN  CHARACTERS  TO  VTI  DATA 

STRUCTURE 

LANGUAGE :  C 

MODULE  TYPE :  FUNCTION 

FUNCTION  TYPE:  BOOL  () 

SOURCE  FILE:  PCHVTI 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM :  UI 

SUBDIRECTORY :  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION: 


SYNOPSIS 

BOOL  PCHVTI () 


INPUTS /OUTPUTS: 


INPUTS : 

NONE 
OUTPUTS : 

RETURNS  FAILURE/SUCCESS 
DESCRIPTION 

THIS  MODULE  TAKES  VT  DATA  IN  "SCREEN"  BUFFER  AND  PUTS  IT 

INTO 

VTI  INTERNAL  DATA  STRUCTURE 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

FUNCTS  -  FUNCTION  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 
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ROUTINES  CALLED: 


TBIT 

ABSPOS  -  ABSOLUTIZE  CURSOR  POSITION  OF  FIELD 

MAX 


CALLED  DIRECTLY  BY: 


GETVT  -  GET  DATA  FROM  VIRTUAL  TERMINAL 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


PRCCMDS 

PROCESS  COMMAND 
C 

SUBROUTINE 
VOID  () 

PRCCMDS 

.C 


SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 


DESCRIPTION: 


SYNOPSIS 

VOID  PRCCMDS (CMD) 
STRUCT  COMMAND  *CMD; 


INPUTS/OUTPUTS : 


INPUTS : 

CMD  -  COMMAND  TO  BE  PROCESSED 

OUTPUTS : 

NONE 

DESCRIPTION 

PROCESSES  INDIVIDUAL  VITTUAL  TERMINAL  COMMANDS 
ARGUMENTS : 


CMD  -  STRUCT  COMMAND  * 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

TERMIO  -  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 
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SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

TRMRTN  -  TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED: 


BLDCMD 

DOSCREEN 

TRMPUT 

TBIT 

ROW 

COL 


DO  COMMAND  TO  INTERNAL  SCREEN 
TERMINAL  PUT 


CALLED  DIRECTLY  BY: 


BVTIDS  -  BUILD  VTI  DATA  STRUCTURE 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM(S) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


PUTVT 

PUT  DATA  TO  VIRTUAL  TERMINAL 
C 

SUBROUTINE 
VOID  (  ) 

PUTVT 
•  C 


SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP.  VIRTERM 


3 

V 

$ 

I 


DESCRIPTION: 


SYNOPSIS 

VOID  PUTVT( BUFF .  LEN ) 

CHAR  ‘BUFF; 

INT  *LEN ; 

DESCRIPTION 

PERFORMS  A  WRITE  TO  THE  VIRTUAL  TERMINAL.  LEN  IS  THE 

NUMBER  OF 

CHARACTERS  IN  BUFF  TO  BE  WRITTEN. 


ARGUMENTS : 


BUFF  =  CHAR  * 

LEN  =  INT  * 


•w 

f-' 


•v 

c 


INCLUDE  FILES: 


STDTYP 

TERM 10 

BITS 

FUNCTS 

SCREEN 

DEVICE 

TRMRTN 


STANDARD  TYPE  DEFINITIONS 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTION  DEFINITIONS 

INTERNAL  SCREEN  DEFINITIONS 

PHYSICAL  DEVICE  DATA  STRUCTURE 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES 


CALLED : 


v 

i; 

i. 

k> 

« 

c 
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BLDCMD 

FNDWND 

- 

FIND  WINDOW 

PRCCMDS 

TBIT 

— 

PROCESS  COMMAND 

TRMFLS 

- 

TERMINAL  FLUSH 

RMVWND 

- 

REMOVE  WINDOW 

DEFWND 

- 

DEFINE  WINDOW 

SWNPRC 

- 

SET  WINDOW  PRECEDENCE 

DEFFLD 

- 

DEFINE  FIELD 

BVTIDS 

- 

BUILD  VTI  DATA  STRUCTURE 

ERAWND 

- 

ERASE  WINDOW 

PCHVTI 

- 

PUT  SCREEN  CHARACTERS  TO  VTI  DATA  STRUCTURE 

CLRMOD 

- 

CLEAR  MODIFY  FLAGS 

GVTICMD 

- 

GET  VIRTUAL  TERMINAL  INTERFACE  COMMAND 

STRDPN 

- 

SET  READ  PENDING  FLAGS 

CALLED  DIRECTLY  BY: 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
INTVT  -  INITIALIZE  VIRTUAL  TERMINAL 

TRMVT  -  TERMINATE  VIRTUAL  TERMINAL 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE 
SOURCE  FILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


PVTICMD 

PUT  VTI  COMMAND 
C 

SUBROUTINE 
VOID  (  ) 

PVTICMD 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  PVTICMD! CMD.  BUFF.  END) 

STRUCT  COMMAND  *CMD . 

CHAR  *  *  BUF .  • END 

DESCRIPTION 

CONVERTS  CMD  TO  CHARACTER  FORM  AND  UPDATE  BUFF  TO  POINT 

TO  THE  CHARACTER 

FOLLOWING  THE  CONVERTED  STRING  END  IS  A  POINTER  TO  THE 

CHARACTER 

FOLLOWING  THE  BUFFER 
ARGUMENTS 

CMD  -  STRUCT  COMMAND  * 

BUFF  -  CHAR  • * 

END  «  CHAR  * 


INCLUDE  FILES 


STDTYP 

BITS 

SCREEN 

FUNCTS 

CTLCHR 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
INTERNAL  SCREEN  DEFINITIONS 
FUNCTION  DEFINITIONS 
CONTROL  CHARACTERS 
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ROUTINES  CALLED 

PVTICMD/ PUTNUM  -  PUT  NUMBER 

CALLED  DIRECTLY  BY 

GETVT  -  GET  DATA  FROM  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module 


Documentat i on 


NAME 
PURPOSE : 

LANGUAGE 
MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST: 

SUBSYSTEM 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


PVTICMD/ PUTNUM 
PUT  NUMBER 
C 

SUBROUTINE 
VOID  (  ) 

PVTICMD 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 


ARGUMENTS 


NUM  -  I  NT 

BUFF  =  CHAR  • » 

END  -  CHAR  • 


INCLUDE  FILES 


STDTYP  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

FUNCTS  -  FUNCTION  DEFINITIONS 

CTLCHR  CONTROL  CHARACTERS 


CALLED  DIRECTLY  BY 

PVTICMD  PUT  VTI  COMMAND 


USED  IN  MAIN  PROGRAM<Si 

DRIVER  MAI  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME 
PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


REFRESH 

REFRESH  TERMINAL 

C 

SUBROUTINE 
VOID  (  ) 

REFRESH 

C 

UI 

DRIVER 

VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  REFRESH( ) 

DESCRIPTION 

CLEARS  THE  TERMINAL  SCREEN  AND  REWRITES  IT  FROM  THE 

INTERNAL  SCREEN 


INCLUDE  FILES: 


STDTYP 

BITS 

SCREEN 

FUNCTS 

TRMRTN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 
INTERNAL  SCREEN  DEFINITIONS 
FUNCTION  DEFINITIONS 
TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED 


BLDCMD 

INVIS 

-  CHECK  FOR 

INVISIBILITY 

ROW 

COL 

TBIT 

TRMPUT 

-  TERMINAL 

PUT 

SBIT 

TRMFLS 

-  TERMINAL 

FLUSH 

CBIT 
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CALLED  DIRECTLY  BY 


TRMPUT 


TERMINAL  PUT 


USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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REFTERM 

REFRESH  TERMINAL 
C 

SUBROUTINE 
VOID  ( ) 

REFTERM 

C 

UI 

DRIVER 


NAME :  REFTERM 

PURPOSE :  REFRESH 

LANGUAGE :  C 

MODULE  TYPE :  SUBROUT] 

FUNCTION  TYPE:  VOID  () 

SOURCE  FILE:  REFTERM 

SOURCE  FILE  TYPE:  C 

HOST: 

SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP  VIRTERM 

DESCRIPTION : 


SYNOPSIS 

VOID  REFTERM ( MIN .  MAX) 

INT  MIN.  MAX; 

DESCRIPTION 

REFRESHES  THE  SPECIFIED  PORTION  OF  THE  TERMINAL  SCREEN 

FROM  THE  INTERNAL 

SCREEN 
ARGUMENTS : 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 

FUNCTS  -  FUNCTION  DEFINITIONS 

TRMRTN  -  TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED 

BLDCMD 

TBIT 
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TRMPUT  -  TERMINAL  PUT 

SBIT 

SL INEND  -  FIND  SCREEN  LINE  END 

CBIT 

COL 

ROW 

MAX 

MIN 


CALLED  DIRECTLY  BY : 


TRMPUT  -  TERMINAL  PUT 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME :  RMVWND 

PURPOSE:  REMOVE  WINDOW 

LANGUAGE :  C 

MODULE  TYPE:  SUBROUTINE 

FUNCTION  TYPE :  VOID  ( ) 

SOURCE  FILE :  RMVWND 

SOURCE  FILE  TYPE.  .C 

HOST: 

SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION: 


SYNOPSIS 

VOID  RMVWND(WNDID) 
INT  WNDID; 


INPUTS /OUTPUTS: 


INPUTS : 

WNDID  -  ID  OF  WNDOW  WISH  TO  REMOVE 

OUTPUTS : 

NONE 

DESCRIPTION 

THIS  MODULE  AFTER  CALLING  FNDWND  TO  GET  POINTER  TO  WNDOW 

INTERESTED  IN 

REMOVING.  UNLINKS  IT  FROM  DATA  STRUCTURE  AND  CALLS  FREWND 

TO  FREE  IT 

AND  ALL  ITS  CHILDREN  WINDOWS  AS  WELL  AS  ALL  DEPENDENT 

FIELDS. 

ARGUMENTS : 


WNDID  -  INT 


INCLUDE  FILES: 
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STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


FNDWND  -  FIND  WINDOW 

ERAWND  -  ERASE  WINDOW 

FREE 


CALLED  DIRECTLY  BY: 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


SLINEND 

FIND  SCREEN  LINE  END 
C 

FUNCTION 
INT  () 

SLINEND 

.C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

INT  SLINEND(POS) 

INT  POS; 

DESCRIPTION 

RETURNS  THE  POSITION  OF  THE  LAST  VISIBLE  CHARACTER  ON  THE 

LINE  CONTAINING 
THE  SPECIFIED  POSITION. 

ARGUMENTS : 


POS  =  INT 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

SCREEN  -  INTERNAL  SCREEN  DEFINITIONS 


ROUTINES  CALLED: 


INVIS  -  CHECK  FOR  INVISIBILITY 

COL 


CALLED  DIRECTLY  BY: 
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REFTERM  -  REFRESH  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME :  STFMTF 

PURPOSE:  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS 

AND  FIELDS 

LANGUAGE :  C 

MODULE  TYPE :  SUBROUTINE 

FUNCTION  TYPE:  VOID  () 

SOURCE  FILE:  STFMTF 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION : 


SYNOPSIS 

VOID  STFMTF ( WNDPT ) ; 
WND  * WNDPT; 


INPUTS/OUTPUTS : 


INPUTS : 

WNDPT  -  POINTER  TO  WINDOW  SETTING  FLAGS  FOR 

OUTPUTS : 

NONE 

DESCRIPTION 

THIS  MODULE  SETS  ALL  FORMAT  CHANGE  FUGS  FOR  WINDOW  AND 

ITS  CHILDREN 
WINDOWS  AND  FIELDS 

ARGUMENTS : 


WNDPT  =  WND  * 


INCLUDE  FILES: 


STDTYP 


STANDARD  TYPE  DEFINITIONS 
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BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED: 


STFMTF  -  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS  AND 

FIELDS 


CALLED  DIRECTLY  BY: 


DEFWND  -  DEFINE  WINDOW 

STFMTF  -  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS  AND 

FIELDS 

SWNPRC  -  SET  WINDOW  PRECEDENCE 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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STRDPN 

SET  READ  PENDING  FLAGS 

C 

SUBROUTINE 
VOID  ( ) 

STRDPN 

C 

UI 

DRIVER 


NAME :  STRDPN 

PURPOSE :  SET  REAI 

LANGUAGE :  C 

MODULE  TYPE:  SUBROUT] 

FUNCTION  TYPE:  VOID  () 

SOURCE  FILE:  STRDPN 

SOURCE  FILE  TYPE:  .  C 

HOST: 

SUBSYSTEM:  UI 

SUBDI RECTORY :  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 

DESCRIPTION : 


SYNOPSIS 

VOID  STRDPN (WNDPT) 

REGISTER  WND  *WNDPT; 

INPUTS/OUTPUTS : 


INPUTS : 

WNDPT  -  POINTER  TO  WINDOW  FROM  WHICH  DATA  IS  TO  BE  READ 

OUTPUTS : 

NONE 

DESCRIPTION 

THIS  MODULE  TURNS  ON  ALL  READ  FLAGS  OF  CHILD  WINDOWS  AND 

FIELDS  WHOSE 

DATA  HAS  IS  TO  BE  PUT  INTO  FORMATED  MESSAGE (TO  BE  SENT 

ACROSS  NTM  TO 

MONITOR)  OF  WINDOW  POINTED  TO  BY  WNDPT 
ARGUMENTS : 


WNDPT  = 


INCLUDE  FILES 


STDTYP 


-  STANDARD  TYPE  DEFINITIONS 
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DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 

ROUTINES  CALLED 

STRDPN  STFDRD  -  SET  FIELD  READ  PENDING 

CALLED  DIRECTLY  BY 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME  STRDPN  STFDRD 

PURPOSE  SET  FIELD  READ  PENDING 

LANGUAGE  C 

MODULE  TYPE  SUBROUTINE 

FUNCTION  TYPE  VOID  ( ) 

SOURCE  FILE  STRDPN 

SOURCE  FILE  TYPE  C 

HOST 

SUBSYSTEM  UI 

SUBDIRECTORY  DRIVER 

DOCUMENTATION  GROUP  VIRTERM 

DESCRIPTION 


ARGUMENTS 


WNDPT  -  WND  * 


INCLUDE  FILES 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 


ROUTINES  CALLED 


STRDPN /STFDRD  -  SET  FIELD  READ  PENDING 


CALLED  DIRECTLY  BY 


STRDPN 1 STFDRD  -  SET  FIELD  READ  PENDING 
STRDPN  -  SET  READ  PENDING  FLAGS 


USED  IN  MAIN  PROGRAM ( S ) 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME 
PURPOSE 
LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE 
SOURCE  FILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 

DESCRIPTION 


SWNPRC 

SET  WINDOW  PRECEDENCE 

C 

SUBROUTINE 
VOID  (  ) 

SWNPRC 

C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  SWNPRC* CMD) 

STRUCT  COMMAND  *CMD; 


INPUTS  OUTPUTS . 


INPUTS 

CMD  -  ADDRESS  OF  COMMAND  STRUCTURE  USED  TO  SET 
PRECEDENCE  OF 

WINDOWS 


OUTPUTS 

NONE 

DESCRIPTION 

THIS  MODULE  REORDERS  PRECEDENCE  OF  WINDOWS.  TAKING  FIRST 

WINDOW  OUT  OF 

LIST  ANDPUTING  IT  AT  THE  HEAD  OF  THE  LIST,  THEN  TAKING 

THE  NEXT  WINDOW 

AND  DOING  THE  SAME  TING  AND  SO  ON  UNTIL  ALL  WINDOW  PASSED 

IN  COMMAND 

STRUCTURE  HAVE  BEEN  PROCESSED 
ARGUMENTS 


CMD  = 


STRUCT  COMMAND 


PS  620144300 
1  November  1985 


INCLUDE  FILES: 

STDTYP  -  STANDARD  TYPE  DEFINITIONS 

BITS  -  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

FUNCTS  -  FUNCTION  DEFINITIONS 

DEVICE  -  PHYSICAL  DEVICE  DATA  STRUCTURE 

ROUTINES  CALLED: 

STFMTF  -  SET  FORMAT  FLAG  FOR  ALL  CHILDREN  WINDOWS  AND 

FIELDS 

CALLED  DIRECTLY  BY: 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION 


SYNOPSIS 

VOID  TPUTNUM(I.  CHAN) 

INT  I; 

TERM  *  CHAN ; 

DESCRIPTION 

CONVERTS  I  TO  CHARACTER  FORM  AND  WRITES  IT  TO  THE 

SPECIFIED  TERMINAL. 


TPUTNUM 

TERMINAL  PUT  NUMBER 

C 

SUBROUTINE 
VOID  (  ) 

TPUTNUM 

.C 

UI 

DRIVER 

VIRTERM 


ARGUMENTS : 


I  =  INT 

CHAN  =  TERM  * 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

TERM 10  -  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 


ROUTINES  CALLED: 


TPUTC 


CALLED  DIRECTLY  BY: 


VT 1 00 / MOVCUR  -  MOVE  CURSOR  (INTERNAL) 
VT100/SETATR  -  SET  ATTRIBUTES  (INTERNAL) 
TRMPUT  -  TERMINAL  PUT 


USED  IN  MAIN  PROGRAM ( S ) : 
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DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME  : 

PURPOSE : 

LANGUAGE 
MODULE  TYPE: 
FUNCTION  TYPE 
SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST: 

SUBSYSTEM 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION 


TPUTS 

TERMINAL  PUT  STRING 
C 

SUBROUTINE 
VOID  (  ) 

TPUTS 

C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  TPUTS ( S ,  CHAN) 

CHAR  *  S ; 

TERM  *CHAN ; 

DESCRIPTION 

WRITES  THE  SPECIFIED  STRING  TO  THE  SPECIFIED  TERMINAL. 
ARGUMENTS : 


S  -  CHAR  * 

CHAN  =  TERM  * 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

TERM 10  -  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 


ROUTINES  CALLED: 


TPUTC 


CALLED  DIRECTLY  BY: 


VT 1 00 / MOVCUR  -  MOVE  CURSOR  (INTERNAL) 
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VT100/SETATR  -  SET  ATTRIBUTES  (INTERNAL) 
TRMPUT  -  TERMINAL  PUT 

TRMEND  -  TERMINAL  END 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER /MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


SYNOPSIS 

I NT  TRMCHK( ) 

DESCRIPTION 

THIS  MODULE  RETURNS  THE  NUMBER  OF  CHARACTERS  IN  THE 

TYPE-AHEAD  BUFFER. 


TRMCHK 

TERMINAL  CHECK 
C 

FUNCTION 
INT  (  ) 

VT100 

C 

UI 

DEVDRV 
:  VIRTERM 


INCLUDE  FILES: 


STD  10 

STDTYP 

CTYPE 

TERM 10 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600.C" 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

STANDARD  TYPE  DEFINITIONS 

»*««  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

***»  PURPOSE  NOT  FOUND  BY  STRIPPER  ***» 


ROUTINES  CALLED: 


TCHECK 


CALLED  DIRECTLY  BY: 


DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


TRMEND 

TERMINAL  END 
C 

SUBROUTINE 
VOID  (  ) 

VT100 

.C 

UI 

DEVDRV 

VIRTERM 


DESCRIPTION : 


SYNOPSIS 

VOID  TRMEND(  ) 


DESCRIPTION 

RESETS  THE  CURRENTLY  OPEN  TERMINAL  AND  CLOSES  IT. 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERMIO 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600.C 


♦**»  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

STANDARD  TYPE  DEFINITIONS 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


PRNEND 

TPUTS  -  TERMINAL  PUT  STRING 

TCLOSE 


CALLED  DIRECTLY  BY: 
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TRMVT  -  TERMINATE  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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TRMFLS 

TERMINAL  FLUSH 
C 

SUBROUTINE 
VOID  ( ) 

VT100 
-C 

UI 

DEVDRV 
VIRTERM 

DESCRIPTION: 


SYNOPSIS 

VOID  TRMFLS ( ) 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


DESCRIPTION 

FLUSH  ANY  TERMINAL  BUFFERS- 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERM 10 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600.C 


**♦*  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

STANDARD  TYPE  DEFINITIONS 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***» 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***♦ 


ROUTINES  CALLED: 


VT 1 00 / MOVCUR  -  MOVE  CURSOR  (INTERNAL) 
TFLUSH 


CALLED  DIRECTLY  BY: 


PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 
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REFRESH  -  REFRESH  TERMINAL 

TRMGET  -  TERMINAL  GET 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


3-125 
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NAME  : 

PURPOSE 
LANGUAGE : 

MODULE  TYPE 
FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


TRMGET 

TERMINAL  GET 
C 

SUBROUTINE 
VOID  (  ) 

VT100 

C 

UI 

DEVDRV 

VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  TRMGET ( CMD ) 

STRUCT  COMMAND  *CMD; 

DESCRIPTION 

GETS  THE  NEXT  COMMAND  FROM  THE  TERMINAL  AND  CONVERTS  IT 

TO  INTERNAL  FORM. 


ARGUMENTS : 


CMD  =  STRUCT  COMMAND  * 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERMIO 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600  C 


•***  PURPOSE  NOT  FOUND  BY  STRIPPER  *•** 

STANDARD  TYPE  DEFINITIONS 

*•**  PURPOSE  NOT  FOUND  BY  STRIPPER  *••• 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

PURPOSE  NOT  FOUND  BY  STRIPPER  *••• 


ROUTINES  CALLED 


BLDCMD 
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PRINTF 

GETCHAR 

TPURGE 

ISPR1NT 

TGETC 

DOSCREEN 

ROW 

COL 

TRMPUT 

TRMFLS 

TBIT 

ISDIGIT 


DO  COMMAND  TO  INTERNAL  SCREEN 


TERMINAL  PUT 
TERMINAL  FLUSH 


CALLED  DIRECTLY  BY: 

GETVT  -  GET  DATA  FROM  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 


PS  620144300 
1  November  1985 


VIRTUAL  TERMINAL  Module  Documentation 


NAME 
PURPOSE 
LANGUAGE 
MODULE  TYPE 
FUNCTION  TYPE 
SOURCE  FILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 

DESCRIPTION 


TRMINI 

TERMINAL  INITIALIZE 

C 

SUBROUTINE 
VOID  (  ) 

VT100 

C 

UI 

DEVDRV 

VIRTERM 


SYNOPSIS 

VOID  TRMINI ( TNAME ) 

CHAR  'TNAME; 

DESCRIPTION 

OPENS  THE  TERMINAL  SPECIFIED  BY  TNAME  AND  INITIALIZES  IT. 
ARGUMENTS . 


TNAME  =  CHAR  * 


INCLUDE  FILES : 


STD  I O 

STDTYP 

CTYPE 

TERMIO 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600  C 


""  PURPOSE  NOT  FOUND  BY  STRIPPER  "" 

STANDARD  TYF_  DEFINITIONS 

""  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

""  PURPOSE  NOT  FOUND  BY  STRIPPER  **" 


ROUTINES  CALLED; 


TBOPEN 
PRN I N I 
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CALLED  DIRECTLY  BY: 

INTVT  -  INITIALIZE  VIRTUAL  TERMINAL 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE 
MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


TRMPUT 

TERMINAL  PUT 
C 

SUBROUTINE 
VOID  (  ) 

VT100 

C 

UI 

DEVDRV 

VIRTERM 


DESCRIPTION 


SYNOPSIS 

VOID  TRMPUT(CMD) 

STRUCT  COMMAND  *CMD; 

DESCRIPTION 

PUTS  AN  INTERNAL  FORMAT  COMMAND  TO  THE  TERMINAL. 
ARGUMENTS : 


CMD  -  STRUCT  COMMAND  * 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERMIO 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600  C" 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  »*** 

STANDARD  TYPE  DEFINITIONS 

****  PURPOSF  NOT  FOUND  BY  STRIPPER  »*** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

*»»*  PURPOSE  NOT  FOUND  BY  STRIPPER 


ROUTINES  CALLED: 


GETCHAR 

PRINTF 
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PRNFLS 

PRNPUT 

REFTERM  -  REFRESH  TERMINAL 

TPUTNUM  -  TERMINAL  PUT  NUMBER 

POS 

TPUTS  -  TERMINAL  PUT  STRING 

REFRESH  -  REFRESH  TERMINAL 

ROW 

COL 

TPUTC 

VT100/SETATR  -  SET  ATTRIBUTES  (INTERNAL) 

SBIT 

FFBSA 

CAB  IT 

FFBDA 

VT 1 00 / MOVCUR  -  MOVE  CURSOR  (INTERNAL) 
TBIT 


CALLED  DIRECTLY  BY: 

PRCCMDS  -  PROCESS  COMMAND 

REFRESH  -  REFRESH  TERMINAL 

REFTERM  -  REFRESH  TERMINAL 

TRMGET  -  TERMINAL  GET 


USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


TRMVT 

TERMINATE  VIRTUAL  TERMINAL 
C 

SUBROUTINE 
VOID  (  ) 

TRMVT 

.C 


SUBSYSTEM:  UI 

SUBDIRECTORY:  DRIVER 

DOCUMENTATION  GROUP:  VIRTERM 


DESCRIPTION: 


SYNOPSIS 

VOID  TRMVT ( ) 


DESCRIPTION 

CLOSES  THE  VTI . 


INCLUDE  FILES: 


STDTYP 

BITS 

SCREEN 

FUNCTS 

CTLCHR 

TRMRTN 


STANDARD  TYPE  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

CONTROL  CHARACTERS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 


ROUTINES  CALLED. 


TRMEND  -  TERMINAL  END 

FREE 

PUTVT  -  PUT  DATA  TO  VIRTUAL  TERMINAL 


CALLED  DIRECTLY  BY: 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
TVTPRC  -  TERMINATE  VTI  PROCESS 
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USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


TVTPRC 

TERMINATE  VTI  PROCESS 
C 

SUBROUTINE 
VOID  (  ) 

TVTPRC 

.C 

UI 

DRIVER 

VIRTERM 


SYNOPSIS 

VOID  TVTPRC ( ) 

DESCRIPTION 

THIS  IS  AN  EXIT  HANDLER  FOR  ABNORMAL  TERMINATIONS 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 


ROUTINES  CALLED: 


TRMNAT 

TRMVT  -  TERMINATE  VIRTUAL  TERMINAL 

EXIT 


CALLED  DIRECTLY  BY: 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
FATAL  -  REPORT  FATAL  ERROR 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI 


MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


VT100/M0VCUR 

MOVE  CURSOR  (INTERNAL) 

C 

SUBROUTINE 
VOID  () 

VT100 

.C 

UI 

DEVDRV 

VIRTERM 


SYNOPSIS 

STATIC  VOID  MOVCURC NEWPOS ) 

INT  NEWPOS; 

DESCRIPTION 

MOVES  THE  TERMINAL  CURSOR  TO  THE  SPECIFIED  POSITION  AND 

RESETS  ANY 
PENDING  POSITION. 

ARGUMENTS : 


NEWPOS  =  INT 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERM 10 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600.C 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

STANDARD  TYPE  DEFINITIONS 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

***»  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 
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TPUTC 

TPUTNUM 

TPUTS 

COL 

ROW 


-  TERMINAL  PUT  NUMBER 

-  TERMINAL  PUT  STRING 


CALLED  DIRECTLY  BY: 

TRMPUT  -  TERMINAL  PUT 

TRMFLS  -  TERMINAL  FLUSH 


USED  IN  MAIN  PROGRAM ( S ) : 


DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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VIRTUAL  TERMINAL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


VT100/ SETATR 

SET  ATTRIBUTES  (INTERNAL) 
C 

SUBROUTINE 
VOID  () 

VT100 

.C 


SUBSYSTEM:  UI 

SUBDIRECTORY:  DEV DRV 

DOCUMENTATION  GROUP:  VIRTERM 


DESCRIPTION: 


SYNOPSIS 

VOID  SETATR(ATR) 

I NT  ATR; 

DESCRIPTION 

SETS  THE  SPECIFIED  TERMINAL  ATTRIBUTES. 
ARGUMENTS : 


ATR  =  I NT 


INCLUDE  FILES: 


STDIO 

STDTYP 

CTYPE 

TERMIO 

BITS 

SCREEN 

FUNCTS 

TRMRTN 

CI600  .  C 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***» 

STANDARD  TYPE  DEFINITIONS 

**»*  PURPOSE  NOT  FOUND  BY  STRIPPER  *•** 

TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

INTERNAL  SCREEN  DEFINITIONS 

FUNCTION  DEFINITIONS 

TERMINAL  (DEVICE  DRIVER)  ROUTINES 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


TPUTNUM  -  TERMINAL  PUT  NUMBER 
TPUTC 
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FFBSA 

TPUTS  -  TERMINAL  PUT  STRING 

CALLED  DIRECTLY  BY: 

TRMPUT  -  TERMINAL  PUT 

USED  IN  MAIN  PROGRAM ( S ) : 

DRIVER/MAI  -  MAIN  MODULE  FOR  WINDOW  MANAGER  AND  DEVICE  DRIVER 
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3.10.9  Include  File  Descriptio.  *>_ 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  BITS 

PURPOSE:  INCLUDE  FILE  FOR  BIT  MANIPULATION  ROUTINES 

LANGUAGE :  C 

DESCRIPTION: 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  CTLCHR 

PURPOSE :  CONTROL  CHARACTERS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DEFINITIONS  OF  ALL  CONTROL  CHARACTERS  TO  AVOID  CHARACTER 

SET 

DEPENDENCIES . 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  DEVICE 

PURPOSE:  PHYSICAL  DEVICE  DATA  STRUCTURE 

LANGUAGE :  C 

DESCRIPTION : 


DESCRIPTION 

THIS  IS  INCLUDE  FILE  FOR  WINDOW  MANAGER.  IT  CONTIANS  DATA 

STRUCTURE 

FOR  THE  PHYSICAL  DEVICE  AND  ITS  LOGICAL  DEVICES  AND 

WINDOWS . 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  DEVINI 

PURPOSE:  DEVICE  INITIALIZATIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

EXTERNAL  DEFINITION  AND  INITIALIZING  INCLUDE  FILE  FOR 

DEVICE. H 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  FUNCTS 

PURPOSE:  FUNCTION  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DEFINES  THE  MNEMONIC  VIRTUAL  TERMINAL  COMMAND  FUNCTIONS. 
AND  DEFINES  STRUCTURE  FOR  PARSING  VTI  MESSAGE  BUFFER. 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  NTM 

PURPOSE:  NTM  INTERFACE  INCLUDE  FILE 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

INCLUDE  FILE  FOR  NTM  INTERFACE 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  SCREEN 

PURPOSE:  INTERNAL  SCREEN  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION : 


DESCRIPTION 

DEFINES  SYMBOLS.  EXTERNALS.  ETC.  FOR  THE  INTERNAL  SCREEN 

BUFFER. 


< 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  STDTYP 

PURPOSE:  STANDARD  TYPE  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

THIS  FILE  ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 

AVAILABLE: 

FLOAT  -  SINGLE  PRECISION  FLOAT 

DOUBLE  -  DOUBLE  PRECISION  FLOAT 

LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LBITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

I NT  -  NATURAL  SIZE  SIGNED  INTEGER 

UNSIGNED  -  NATURAL  SIZE  UNSIGNED  INTEGER 

BOOL  -  NATURAL  SIZE  LOGICAL  (ZERO  /  NON-ZERO  ONLY) 

SHORT  -  16  BIT  (OR  LARGER)  SIGNED  INTEGER 

USHORT  -  16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

BITS  -  16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

CHAR  -  SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 

ALWAYS  POSITIVE) 

TINY  -  8  BIT  (OR  LARGER)  SIGNED  INTEGER 

UTINY  -  8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

TBITS  -  8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 
TBOOL  -  8  BIT  (OR  LARGER)  LOGICAL  (ZERO  /  NON-ZERO 
ONLY) 

METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 
(SIGNED) 

VOID  -  FUNCTION  THAT  RETURNS  NO  VALUE 

FORTRAN  -  STORAGE  CLASS  FOR  FOREIGN  (NON-C)  ROUTINES 
OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 

SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT,  TINY.  AND  UTINY. 

THE  FUNCTIONS 
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USHORT( ) ,  TINY ( ) ,  AND  UTINY( )  SHOULD  BE  USED  WHENEVER 

REFERENCING  THEM. 

IN  ADDITION.  THE  FOLLOWING  UTILITY  MACROS  ARE  DEFINED: 
LURSHIFT( N ,  B)  -  UNSIGNED  LONG  RIGHT  SHIFT 
MAX( A ,  B)  -  MAXIMUM  OF  A  AND  B 

MIN( A ,  B)  -  MINIMUM  OF  A  AND  B 
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VIRTUAL  TERMINAL  Include  File  Description 


ABS(A) 

STRASN ( A ,  B) 

NULL 

TRUE 

FALSE 

SUCCESS 

FAILURE 


-  ABSOLUTE  VALUE  OF  A 

-  TRANSPORTABLE  A  -  B  FOR  STRUCTURES 

-  NULL  POINTER  VALUE  (0) 

-  1 
-  0 

-  EXIT( SUCCESS)  INDICATES  SUCCESSFUL 
COMPLETION 

-  EXIT( FAILURE)  INDICATES  ERRORS 


THE  FOLLOWING  SYMBOLS  SHOULD  BE  DEFINED  BASED  ON  THE 

COMPILER  BEING  USED: 

USHORT  -  COMPILER  SUPPORTS  UNSIGNED  SHORT 
TINY  -  COMPILER  TREATS  CHAR  AS  SIGNED 
UTINY  -  CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 
UNSIGNED  CHAR 

VOID  -  COMPILER  SUPPORTS  VOID 
FORTRAN  -  COMPILER  SUPPORTS  FORTRAN 
STRASN  -  DEFINE  APPROPRIATE  MACRO 
SUCCESS  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  0 
FAILURE  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  1 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  TERM 10 

PURPOSE:  TRANSPARENT  TERMINAL  I/O  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION : 
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VIRTUAL  TERMINAL  Include  File  Description 


FILE  NAME:  TRMRTN 

PURPOSE:  TERMINAL  (DEVICE  DRIVER)  ROUTINES 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DECLARATIONS  FOR  ALL  TRM*  DEVICE  SPECIFIC  DEVICE  DRIVER 

ROUTINES . 


PS  620144300 
1  November  1985 


3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  i s  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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ABSPOS 

ISPRINT 

BLDCMD 

LIMIT 

BLDMSG . 

.  .  .20 

MALLOC 

BLDMSG/  BLDBUF . 

.  .  .20 

MAX 

BLDMSG/ REDOFF. 

.  24 

MEMCMP 

BVTIDS . 

...  1 1 

MEMCPY 

BVTIDS/BVTIFM. 

.  .  .22 

MEMSET 

BVTIDS/CLRFLG. 

...  11 

MIN 

BVTIDS/CVTIFM 

...  18 

NSEND 

BVTIDS/ INSFLD . 

.  .  .22 

PCHVTI . 

.  12 

BVTIDS/RVTIFM. 

...  18 

POS 

CAB  IT 

PRCCMDS . 

.27 

CALLOC 

PRINTF 

CBIT 

PRNEND 

CLRMOD . 

...  .8 

PRNFLS 

COL 

PRNINI 

CSTR 

PRNPUT 

DEFFLD . 

...  .7 

PUTC 

DEFVND . 

.6 

PUTVT . 

.  .2 

DELAY 

PVTICMD . 

.  16 

DOSCR/ ERASE  . 

.  .  .34 

PVT I CMD/ PUTNUM 

DOSCR/HSCR . . 

.28 

RCV 

DOSCR/VSCR  . 

.  .  .33 

REFRESH . 

.36 

DOSCREEN 

.  .  .28 

REFTERM . 

.31 

DRIVER/MAIN 

...  1 

RMVWND . 

.  .4 

ERAWND 

.  8 

ROW 

EXIT 

SBIT 

FATAL . 

....  5 

SIGNAL 

FCLOSE 

SLINEND . 

.  31 

FFBDA 

SPRINTF 

FFBSA 

STFMTF . 

.  .6 

FFBSB 

STRASN 

FIX 

STRCAT 

FLOOR 

STRCPY 

FNDVND 

.2 

STRDPN . 

.  13 

FOPEN 

STRDPN/ STFDRD 

.  13 

FPRINTF 

STRLEN 

FREE 

SWNPRC 

.  4 

FSEARCH 

TBIT 

FWRITE 

TBOPEN 

GETCHAR 

TCHECK 

GETVT . 

.16 

TCLOSE 

GVTICMD 

13 

TFLUSH 

INITEX 

TGETC 

INTVT 

9 

TO LOWER 

INVIS 

.  36 

TPURGE 

ISDIGIT 

TPUTC 
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TPUTNUM . 29 

TPUTS . 10 

TRHCHK . 10 

TRMEND . 10 

TRMFLS . 2 

TRMGET . 19 

TRMINI . 9 

TRMNAT 

TRMPUT . 27 

TRMVT . 10 

TVTPRC . 1 

VT 1 00  /  MOVCUR . 2 

VT100/SETATR . 37 

ZERO 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


“Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  “Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

‘Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
perf  ormed . 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "anti bugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs.” 


